Splunk® Enterprise

Managing Indexers and Clusters of Indexers

Splunk Enterprise version 7.2 is no longer supported as of April 30, 2021. 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® Enterprise. For documentation on the most recent version, go to the latest release.

Peer node configuration overview

Configuration of the peer nodes falls under two categories:

  • Configuration of the basic indexer cluster settings, such as the master URI and the replication port.
  • Configuration of input, indexing, and related settings. This includes the deployment of apps to the peer nodes.

Initial configuration

Most peer cluster configuration happens during initial deployment:

1. When you enable the peer, you specify its cluster settings, such as its master node and the port on which it receives replicated data. See Enable the peer nodes.

2. After you enable the set of peers, you configure their indexes, if necessary. See Configure the peer indexes in an indexer cluster.

3. Finally, you configure their inputs, usually by means of forwarders. See Use forwarders to get data into the indexer cluster.

These are the key steps in configuring a peer. You might also need to update the configurations later, as with any indexer.

Change the cluster configuration

There are two main reasons to change the cluster node configuration:

  • Redirect the peer to another master. This can be useful in the case where the master fails but you have a stand-by master ready to take over. For information on stand-by masters, see Replace the master node on the indexer cluster.
  • Change the peer's security key for the cluster. Only change the key if you are also changing it for all other nodes in the cluster. The key must be the same across all instances in a cluster.

To edit the cluster configuration, change each peer node individually, using one of these methods:

For additions and differences when configuring multisite peer nodes, see Configure multisite indexer clusters with server.conf.

Configure indexing and related behavior

The set of index stanzas in indexes.conf must be identical across all peers, aside from very limited exceptions described in Manage configurations on a peer-by-peer basis. It is also important that index-time processing be the same across the peers. For the cluster to properly replicate data and handle node failover, peers must share the same indexing functionality, and they cannot do this if certain key files vary from peer to peer.

As a best practice, you should treat your peers as interchangeable, and therefore you should maintain identical versions of configuration files and apps across all peers. At the least, the following files should be identical:

  • indexes.conf
  • props.conf
  • transforms.conf

To ensure that the peers share a common set of configuration files and apps, place the files and apps on the master and then use the configuration bundle method to distribute them, in a single operation, to the set of peers.

These topics describe how to maintain identical configurations across the set of peers:

Manage single-peer configurations

You might occasionally need to handle some configurations on a peer-by-peer basis, for testing or other purposes. As a general rule, however, try to use the same configurations across all peers, so that the peers are interchangeable.

For information on single-peer configuration, see Manage configurations on a peer-by-peer basis.

Last modified on 23 September, 2020
Replace the master node on the indexer cluster   Configure peer nodes with the dashboard

This documentation applies to the following versions of Splunk® Enterprise: 7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7, 7.0.8, 7.0.9, 7.0.10, 7.0.11, 7.0.13, 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 7.1.8, 7.1.9, 7.1.10, 7.2.0, 7.2.1, 7.2.2, 7.2.3, 7.2.4, 7.2.5, 7.2.6, 7.2.7, 7.2.8, 7.2.9, 7.2.10, 7.3.0, 7.3.1, 7.3.2, 7.3.3, 7.3.4, 7.3.5, 7.3.6, 7.3.7, 7.3.8, 7.3.9, 8.0.0, 8.0.1, 8.0.2, 8.0.3, 8.0.4, 8.0.5, 8.0.6, 8.0.7, 8.0.8, 8.0.9, 8.0.10

Acrobat logo Download manual
Acrobat logo Download this page

Was this topic useful?







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