Enable cross-cluster searchedit

Cross-cluster search (CCS) allows you to configure multiple remote deployments, and enable federated search queries across all of the configured deployments.

Cluster settings are automatically maintained and updated when cluster topologies change. For example, all connected clusters are updated when:

  • A cluster is deleted
  • A node is added or removed from a cluster

Once your remotes are configured, you can run CCS queries from Elasticsearch.

Cross-cluster search is not supported for AWS Marketplace accounts.

Before you beginedit

To enable CCS, you must meet the following criteria:

  • All deployments must be version 6.7.x or later.

  • To access the RESTful API for Elasticsearch Service, you must use your Elasticsearch Service credentials.

Establish remote deployment relationshipsedit

The CCS deployment acts as a hub that manages all of the remote deployment connections.

  1. Log in to the Elasticsearch Service Console.
  2. Click Create deployment.
  3. Select the Elastic Stack solution
  4. Select the Cross Cluster Search hardware profile.
  5. Decide when to add the remote connections:

    • If you know the deployments that you want to include, click Customize deployment to define the remotes while creating the deployment.
    • After the deployment is spun up, you can add remotes from the deployment overview page.
  6. Click Add deployment.
  7. Select a target deployment from the Deployment name drop-down list.

    Only the compatible deployments appear on this list.

  8. Optional: Update the generated alias to something meaningful to you.
  9. Save your changes.
  10. Verify the configuration by running CCS queries from Elasticsearch.
  11. As needed, from the Elasticsearch API or Kibana, update the Elasticsearch cluster security and user access roles to allow them to access the remote deployments.

The target deployment overview page shows which CCS deployments can search the target.