Configure the master with server.conf
Read this first
Before reading this topic, see:
- "Configure the indexer cluster with server.conf". This topic explains the basics of cluster configuration. It provides details on issues that are common to all cluster node types.
Enable the master node
The following example shows the basic settings that you must configure when enabling a master node. The configuration attributes correspond to fields on the Enable clustering page of Splunk Web.
[clustering] mode = master replication_factor = 4 search_factor = 3 pass4SymmKey = whatever
This example specifies that:
- the instance is a cluster master node.
- the cluster's replication factor is 4.
- the cluster's search factor is 3.
- the secret key is "whatever".
Important: When the master starts up for the first time, it will block indexing on the peers until you enable and restart the full replication factor number of peers. Do not restart the master while it is waiting for the peers to join the cluster. If you do, you will need to restart the peers a second time.
Note: When you enable the master node in Splunk Web, the resulting
server.conf stanza includes attributes only for non-default values. For example, if you accept the default replication factor of 3 and do not enter a new value for it, the resulting stanza does not include the
Edit the master settings
You can change these settings later, if necessary. For example, to change the cluster's secret key, you edit the
pass4SymmKey value on each node.
For details on all cluster attributes, including some advanced ones that rarely require editing, read the server.conf specification.
Configure the cluster master with the dashboard
Configure the master with the CLI
This documentation applies to the following versions of Splunk® Enterprise: 6.1, 6.1.1, 6.1.2, 6.1.3, 6.1.4, 6.1.5, 6.1.6, 6.1.7, 6.1.8, 6.1.9, 6.1.10, 6.1.11, 6.1.12, 6.1.13, 6.1.14, 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