2019-03-13 19:14:08 +01:00
|
|
|
|
[[working-remote-clusters]]
|
2020-02-06 18:16:32 +01:00
|
|
|
|
== Remote Clusters
|
2019-03-13 19:14:08 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
Use *Remote Clusters* to establish a unidirectional
|
|
|
|
|
connection from your cluster to other clusters. This functionality is
|
|
|
|
|
required for {ref}/xpack-ccr.html[cross-cluster replication] and
|
|
|
|
|
{ref}/modules-cross-cluster-search.html[cross-cluster search].
|
2019-03-13 19:14:08 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
To get started, go to *Management > Remote Clusters*.
|
2019-03-13 19:14:08 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
[role="screenshot"]
|
|
|
|
|
image::images/remote-clusters-list-view.png[Remote Clusters list view, including Add a remote cluster button]
|
2019-03-13 19:14:08 +01:00
|
|
|
|
|
|
|
|
|
[float]
|
2019-01-18 15:32:24 +01:00
|
|
|
|
[[managing-remote-clusters]]
|
2020-04-16 22:29:23 +02:00
|
|
|
|
=== Add a remote cluster
|
2020-02-06 18:16:32 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
A {ref}/modules-remote-clusters.html[remote cluster] connection works by configuring a remote cluster and
|
|
|
|
|
connecting to a limited number of nodes, called {ref}/modules-remote-clusters.html#sniff-mode[seed nodes],
|
|
|
|
|
in that cluster.
|
|
|
|
|
Alternatively, you can define a single proxy address for the remote cluster.
|
2019-01-18 15:32:24 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
By default, a cross-cluster request, such as a cross-cluster search or
|
|
|
|
|
replication request, fails if any cluster in the request is unavailable.
|
|
|
|
|
To skip a cluster when its unavailable,
|
|
|
|
|
set *Skip if unavailable* to true.
|
2019-01-18 15:32:24 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
Once you add a remote cluster, you can configure <<managing-cross-cluster-replication, cross-cluster replication>>
|
|
|
|
|
to reproduce indices in the remote cluster on a local cluster.
|
2019-01-18 15:32:24 +01:00
|
|
|
|
|
|
|
|
|
[role="screenshot"]
|
|
|
|
|
image::images/add_remote_cluster.png[][UI for adding a remote cluster]
|
|
|
|
|
|
2020-06-05 20:09:45 +02:00
|
|
|
|
To create an index pattern to search across clusters,
|
|
|
|
|
use the same syntax that you’d use in a raw cross-cluster search request in {es}: <cluster-names>:<pattern>.
|
|
|
|
|
See <<management-cross-cluster-search, Creating an index pattern>> for examples.
|
|
|
|
|
|
2019-03-13 19:14:08 +01:00
|
|
|
|
[float]
|
2020-04-16 22:29:23 +02:00
|
|
|
|
[[manage-remote-clusters]]
|
|
|
|
|
=== Manage remote clusters
|
2019-03-13 19:14:08 +01:00
|
|
|
|
|
2020-04-16 22:29:23 +02:00
|
|
|
|
From the *Remote Clusters* list view, you can drill down into each cluster and
|
|
|
|
|
view its status. You can also edit and delete a cluster.
|