Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/changelog/117154.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
pr: 117154
summary: "Add CCS based reindex to docs"
area: Search
type: bug
issues: []
29 changes: 29 additions & 0 deletions docs/reference/docs/reindex.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ privilege for the source data stream, index, or alias.
in the `reindex.remote.whitelist` setting of `elasticsearch.yml`. See
<<reindex-from-remote>>.

* If CCS-based reindexing from a remote cluster, you must add the remote cluster setting. See
<<add-remote-clusters>>.

* Automatic data stream creation requires a matching index template with data
stream enabled. See <<set-up-a-data-stream>>.

Expand Down Expand Up @@ -1119,6 +1122,32 @@ POST _reindex
// TEST[s/otherhost:9200/\${host}/]
// TEST[s/\.\.\.,/"username": "test_admin", "password": "x-pack-test-password",/]

[[CCS-based-reindex-from-remote]]
==== CCS based reindex from remote

Reindex supports CCS based reindexing from a remote Elasticsearch cluster:

[source,console]
--------------------------------------------------
POST _reindex
{
"source": {
"index": "cluster_one:my-index-000001"
},
"dest": {
"index": "my-new-index-000001"
}
}
--------------------------------------------------
// TEST[setup:my_index_big]

The `index` parameter must be specified with the remote cluster name and the index name, separated by
a colon (e.g., cluster_one:my-index-000001).
Additionally, you must configure the remote cluster in advance and retrieve the remote cluster name.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't follow what "retrieve the remote cluster name" means here.
Perhaps, it should all be rephrased more simply such as: "Note that reindexing requires that the remote cluster be configured on the local cluster."

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That certainly seems confusing.
I'll rephrase it to a simpler version.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For more details, refer to the reference for <<add-remote-clusters>>.

NOTE: Needs v8.12.0 or later on the reindexing cluster.

[[reindex-ssl]]
===== Configuring SSL parameters

Expand Down