System requirements and other deployment considerations for distributed search
This topic describes the key considerations when deploying a basic distributed search topology with search heads that function independently of each other. If instead you are deploying a search head cluster, see System requirements and other deployment considerations for search head clusters.
Hardware requirements for distributed search instances
For information on the hardware requirements for search heads and search peers (indexers), see Reference hardware in the Capacity Planning Manual.
Splunk Enterprise version compatibility
Upgrade search heads and search peers at the same time to take full advantage of the latest search capabilities. If you cannot do so, follow these version compatibility guidelines.
Compatibility between search heads and search peers
The following rules define compatibility requirements between search heads and search peers:
- 6.x search heads are compatible with 6.x and 5.x search peers.
- The search head must be at the same or a higher level than the search peers. See the note later in this section for a precise definition of "level" in this context.
Here is a non-exhaustive set of examples illustrating the sort of combinations that are compatible:
- A 6.3 search head is compatible with a 5.0 search peer.
- A 6.4 search head is compatible with a 6.3 search peer.
- A 6.4 search head is compatible with a 6.4 search peer.
In contrast, here are examples of some combinations that are not compatible:
- A 5.0 search head is not compatible with a 6.4 search peer.
- A 6.3 search head is not compatible with a 6.4 search peer.
Note the following:
- These guidelines are valid for standalone search heads and for search heads that are participating in a search head cluster.
- Search heads participating in indexer clusters have different compatibility restrictions. See Splunk Enterprise version compatibility in Managing Indexers and Clusters of Indexers.
- Compatibility is significant at the major/minor release level, but not at the maintenance level. For example, a 6.3 search head is not compatible with a 6.4 search peer, because the 6.3 search head is at a lower minor release level than the 6.4 search peer. However, a 6.3.1 search head is compatible with a 6.3.3 search peer, despite the lower maintenance release level of the search head.
Mixed-version distributed search compatibility
You can run a 6.x search head against 5.x search peers, but there are a few compatibility issues to be aware of. To take full advantage of the 6.x feature set, upgrade search heads and search peers at the same time.
This section describes the compatibility issues.
6.x features in a mixed-version deployment
When running a 6.x search head against 5.x search peers, note the following:
- You can use data models on the search head, but only without report acceleration.
- You can use Pivot on the search head.
- You can run predictive analytics (the
predictcommand) on the search head.
Licenses for distributed search
Synchronize system clocks across the distributed search environment
Synchronize the system clocks on all machines, virtual or physical, that are running Splunk Enterprise distributed search instances. Specifically, this means your search heads and search peers. In the case of search head pooling or mounted bundles, this also includes the shared storage hardware. Otherwise, various issues can arise, such as bundle replication failures, search failures, or premature expiration of search artifacts.
The synchronization method that you use depends on your specific set of machines. Consult the system documentation for the particular machines and operating systems on which you are running Splunk Enterprise. For most environments, Network Time Protocol (NTP) is the best approach.
Deploy a distributed search environment
Add search peers to the search head
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, 6.3.0, 6.3.1, 6.3.2, 6.3.3, 6.3.4, 6.3.5, 6.3.6, 6.3.7, 6.3.8, 6.3.9, 6.3.10, 6.3.11, 6.3.12, 6.3.13, 6.4.0, 6.4.1, 6.4.2, 6.4.3, 6.4.4, 6.4.5, 6.4.6, 6.4.7, 6.4.8, 6.4.9, 6.4.10, 6.4.11, 6.5.0, 6.5.1, 6.5.1612 (Splunk Cloud only), 6.5.2, 6.5.3, 6.5.4, 6.5.5, 6.5.6, 6.5.7, 6.5.8, 6.5.9, 6.5.10, 6.6.0, 6.6.1, 6.6.2, 6.6.3, 6.6.4, 6.6.5, 6.6.6, 6.6.7, 6.6.8, 6.6.9, 6.6.10, 6.6.11, 6.6.12