Splunk® Enterprise

Distributed Search

Download manual as PDF

Splunk Enterprise version 6.x is no longer supported as of October 23, 2019. See the Splunk Software Support Policy for details. For information about upgrading to a supported version, see How to upgrade Splunk Enterprise.
This documentation does not apply to the most recent version of Splunk. Click here for the latest version.
Download topic as PDF

Integrate the search head cluster with an indexer cluster

To integrate a search head cluster with an indexer cluster, you must configure each member of the search head cluster as a search head on the indexer cluster. Once you have done that, the search heads will get their list of search peers from the master node of the indexer cluster.

In this diagram, a search head cluster performs searches across a single-site indexer cluster:

SH cluster with Indexer Cluster.png

Integrate with an indexer cluster

Configure each search head cluster member as a search head on the indexer cluster. Use the CLI splunk edit cluster-config command. For example:

splunk edit cluster-config -mode searchhead -master_uri -secret newsecret123 

splunk restart

This example specifies:

  • The instance is a search head in an indexer cluster.
  • The master node of the indexer cluster resides at
  • The security key is "newsecret123". You must use the same security key across all nodes in both the indexer cluster and the search head cluster.

You must do this for each member of the search head cluster.

This is all you need for the basic configuration. The search heads now run their searches against the peer nodes in the indexer cluster.

For more information

For more information on configuration of search heads on indexer clusters, see the chapter "Configure the search head" in the Managing Indexers and Clusters of Indexers manual. That chapter also includes configuration for more complex scenarios, such as hybrid searching, where the search heads search across both indexer clusters and non-clustered indexers.

Deploy a search head cluster
Connect the search heads in clusters to search peers

This documentation applies to the following versions of Splunk® Enterprise: 6.2.0, 6.2.1, 6.2.2, 6.2.3, 6.2.4, 6.2.5, 6.2.6, 6.2.7, 6.2.8, 6.2.9, 6.2.10, 6.2.11, 6.2.12, 6.2.13, 6.2.14, 6.2.15

Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters