Configure the manager node with server.conf
Prerequisites
Before reading this topic, see Configure the indexer cluster with server.conf. It discusses configuration issues that are common to all cluster node types.
Enable the manager node
The following example shows the basic settings that you configure when enabling a manager node. Unless otherwise noted, the settings are required. The configuration attributes correspond to fields on the Enable clustering page of Splunk Web.
[clustering] mode = manager replication_factor = 4 search_factor = 3 pass4SymmKey = whatever cluster_label = cluster1
This example specifies that:
- the instance is a cluster manager node.
- the cluster's replication factor is 4.
- the cluster's search factor is 3.
- the security key is "whatever". All nodes in the cluster use the same security key. See Configure the security key.
- the cluster label is "cluster1." The optional cluster label is useful for identifying the cluster in the monitoring console. See Set cluster labels in Monitoring Splunk Enterprise. You set this attribute on the manager node only.
When the manager node 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 manager while it is waiting for the peers to join the cluster. If you do, you will need to restart the peers a second time.
When you enable the manager 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 replication_factor
attribute.
Edit the manager node settings
You can change these settings later, if necessary. For example, to change the cluster's security 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 manager node with the dashboard | Configure the manager node with the CLI |
This documentation applies to the following versions of Splunk® Enterprise: 8.1.0, 8.1.1, 8.1.2, 8.1.3, 8.1.4, 8.1.5, 8.1.6, 8.1.7, 8.1.8, 8.1.9, 8.1.10, 8.1.11, 8.1.12, 8.1.13, 8.1.14, 8.2.0, 8.2.1, 8.2.2, 8.2.3, 8.2.4, 8.2.5, 8.2.6, 8.2.7, 8.2.8, 8.2.9, 8.2.10, 8.2.11, 8.2.12, 9.0.0, 9.0.1, 9.0.2, 9.0.3, 9.0.4, 9.0.5, 9.0.6, 9.0.7, 9.0.8, 9.0.9, 9.0.10, 9.1.0, 9.1.1, 9.1.2, 9.1.3, 9.1.4, 9.1.5, 9.1.6, 9.2.0, 9.2.1, 9.2.2, 9.2.3, 9.3.0, 9.3.1
Feedback submitted, thanks!