Add migration note for remote cluster settings (#33632)
The remote cluster settings search.remote.* have been renamed to cluster.remote.* and are automatically upgraded in the cluster state on gateway recovery, and on put. This commit adds a note to the migration docs for these changes.
This commit is contained in:
parent
901d8035d9
commit
c023f67c5d
|
@ -40,3 +40,16 @@ will be removed in the future, thus requiring HTTP to always be enabled.
|
||||||
This setting has been removed, as disabling http pipelining support on the server
|
This setting has been removed, as disabling http pipelining support on the server
|
||||||
provided little value. The setting `http.pipelining.max_events` can still be used to
|
provided little value. The setting `http.pipelining.max_events` can still be used to
|
||||||
limit the number of pipelined requests in-flight.
|
limit the number of pipelined requests in-flight.
|
||||||
|
|
||||||
|
==== Cross-cluster search settings renamed
|
||||||
|
|
||||||
|
The cross-cluster search remote cluster connection infrastructure is also used
|
||||||
|
in cross-cluster replication. This means that the setting names
|
||||||
|
`search.remote.*` used for configuring cross-cluster search belie the fact that
|
||||||
|
they also apply to other situations where a connection to a remote cluster as
|
||||||
|
used. Therefore, these settings have been renamed from `search.remote.*` to
|
||||||
|
`cluster.remote.*`. For backwards compatibility purposes, we will fallback to
|
||||||
|
`search.remote.*` if `cluster.remote.*` is not set. For any such settings stored
|
||||||
|
in the cluster state, or set on dynamic settings updates, we will automatically
|
||||||
|
upgrade the setting from `search.remote.*` to `cluster.remote.*`. The fallback
|
||||||
|
settings will be removed in 8.0.0.
|
||||||
|
|
|
@ -52,6 +52,11 @@ import java.util.stream.Stream;
|
||||||
*/
|
*/
|
||||||
public abstract class RemoteClusterAware extends AbstractComponent {
|
public abstract class RemoteClusterAware extends AbstractComponent {
|
||||||
|
|
||||||
|
static {
|
||||||
|
// remove search.remote.* settings in 8.0.0
|
||||||
|
assert Version.CURRENT.major < 8;
|
||||||
|
}
|
||||||
|
|
||||||
public static final Setting.AffixSetting<List<String>> SEARCH_REMOTE_CLUSTERS_SEEDS =
|
public static final Setting.AffixSetting<List<String>> SEARCH_REMOTE_CLUSTERS_SEEDS =
|
||||||
Setting.affixKeySetting(
|
Setting.affixKeySetting(
|
||||||
"search.remote.",
|
"search.remote.",
|
||||||
|
|
|
@ -66,6 +66,11 @@ import static org.elasticsearch.common.settings.Setting.boolSetting;
|
||||||
*/
|
*/
|
||||||
public final class RemoteClusterService extends RemoteClusterAware implements Closeable {
|
public final class RemoteClusterService extends RemoteClusterAware implements Closeable {
|
||||||
|
|
||||||
|
static {
|
||||||
|
// remove search.remote.* settings in 8.0.0
|
||||||
|
assert Version.CURRENT.major < 8;
|
||||||
|
}
|
||||||
|
|
||||||
public static final Setting<Integer> SEARCH_REMOTE_CONNECTIONS_PER_CLUSTER =
|
public static final Setting<Integer> SEARCH_REMOTE_CONNECTIONS_PER_CLUSTER =
|
||||||
Setting.intSetting("search.remote.connections_per_cluster", 3, 1, Setting.Property.NodeScope, Setting.Property.Deprecated);
|
Setting.intSetting("search.remote.connections_per_cluster", 3, 1, Setting.Property.NodeScope, Setting.Property.Deprecated);
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue