Getting Data In

do you need to restart splunkd if I modify the add/remove peer node from a search cluster or indexer cluster?

danielwan
Explorer

If I add or remove a peer node into/from a existing search head cluster or indexer cluster, do I need to restart splunkd? If I do it via CLI, is it required to restart splunkd? how about doing it via editing configuration file?

I went through http://docs.splunk.com/Documentation/Splunk/7.0.0/Indexer/Restartthecluster but it seems to be vague.

0 Karma

esix_splunk
Splunk Employee
Splunk Employee

Indexing and Search Head Cluster peer removal process is different... Both of them, the options from the GUI are limited..

For removing a peer from a Indexing Cluster, you need to run a splunk offline from the peer you want to remove. Once you do that and the peer gracefully removes itself from the Cluster, you can either restart the CM for it to disappear (not recommended) or follow the process listed below..

See the following Documentation :
https://docs.splunk.com/Documentation/Splunk/7.0.0/Indexer/Takeapeeroffline
https://docs.splunk.com/Documentation/Splunk/7.0.0/Indexer/Removepeerfrommasterlist

For a SHC, peer removal is a bit less convoluted.. essentially from the peer you want to remove, you need to run the splunk remove shcluster-member, or from another peer you can run the following : splunk remove shcluster-member -mgmt_uri https://hostnameofpeertoremove:8089

See docs :

https://docs.splunk.com/Documentation/Splunk/7.0.0/DistSearch/Removeaclustermember

Note that this can have adverse effects on your SHC, especially when you dont have enough peers remaining to elect the new captain.

If you follow the above processes, which are the recommended methods of doing this, you do not need to restart Splunk. You could edit the configuration files, but doing so would require a restart of Splunk.

0 Karma

hardikJsheth
Motivator

If you do it via CLI , you don't need to restart Splunkd. However, if you do it via updating configuration files, you need to restart the Splunkd services.

0 Karma
Got questions? Get answers!

Join the Splunk Community Slack to learn, troubleshoot, and make connections with fellow Splunk practitioners in real time!

Meet up IRL or virtually!

Join Splunk User Groups to connect and learn in-person by region or remotely by topic or industry.

Get Updates on the Splunk Community!

Observability Simplified: Combining User Experience, Application Performance & ...

Tech Talk Observability Simplified: Combining User Experience, Application Performance & Network ...

Event Series May & June: From Network Visibility to Service Intelligence

Unifying the Network: Moving from Alert Noise to Service Intelligence with Splunk ITSI In today’s hybrid ...

Global Splunk User Group Events: May + June 2026

Your Splunk Community Awaits: Discover Upcoming User Group Events Worldwide    Staying ahead in the fast-paced ...