Splunk-2-Splunk Setup
This documentation does not apply to the most recent version of Splunk. Click here for the latest version.
Contents
Splunk-2-Splunk Setup
2.0 Splunk-2-Splunk migration
If you have a network of Splunk 2.0.x servers configured for Splunk-2-Splunk distributed data access, see the 2.0 to 2.1 Migration Instructions.
Splunk 2.1 lets you configure Splunk-2-Splunk data forwarding, data receving and distributed search on the Admin page of Splunk's GUI, or through the command line interface. Both have built-in help. The GUI displays a diagram of which servers are fowarding, receiving, or handling distributed searches.
Browser-based configuration
- Login to your Splunk Server's browser interface.
- Click Admin in the upper left corner of the server's home page.
- Click the Splunk-2-Splunk tab to find Splunk-2-Splunk configuration controls.
- For help, click the (i) button next to each section of controls.
Command line configuration
Type this command to see built-in help for configuring the Splunk Server:
# /opt/splunk/bin/splunk help s2s
Below are the built-in command line help entries related to Splunk-2-Splunk configuration.
s2s (splunk-2-splunk)
Splunk-2-Splunk configuration management
These commands require a Splunk Professional license.
Actions
- enable [discoverable|listen|dist-search] [-parameter value] ...
- disable [discoverable|listen|dist-search] [-parameter value] ...
- display [discoverable|listen|dist-search]
- add [forward-server|search-server] server
- remove [forward-server|search-server] server
- list [forward-server|search-server]
Objects
- discoverable
broadcast availability for Distributed Search from other Splunk Servers
- dist-search
distribute searches to other Splunk Servers
- listen
reception of data to be indexed from other Splunk Servers
- forward-server
a Splunk Server to which to forward data to be indexed
- search-server
a Splunk Server to which to forward searches
Default Parameter
Required Parameters
Optional Parameters
Type "help [object]" to see the parameters specific to each type of object.
Examples
# splunk enable listen 18089
# splunk enable discoverable -auth gwb:d3cidr
search-server
Splunk-2-Splunk distributed search configuration management
These commands require a Splunk Professional license.
Actions & Objects
- add search-server [name] [-parameter value] ...
- remove search-server [name]
- list search-server
Default Parameter
- server
the Splunk Server name of the server to configure
Required Parameters
- server
Optional Parameters
- auth
username:password to authenticate the command to a Splunk Professional server
Examples
# splunk add search-server production02 -auth gwb-d3cidr
forward-server
Splunk-2-Splunk data forwarding configuration management
These commands require a Splunk Professional license.
Actions
- add forward-server [server] [-parameter value] ...
- remove forward-server [server]
- list forward-server
Default Parameter
- server
the Splunk Server name of the server to configure
Required Parameter
- server
Optional Parameters
- auth
username:password to authenticate the command to a Splunk Professional server
Examples
# splunk add forward-server production02 -auth gwb:d3cidr
enable, disable, display, discoverable, listen, dist-search
Actions
- enable [discoverable|dist-search]
- enable [listen] [port]
- disable [discoverable|listen|dist-search]
- display [discoverable|listen|dist-search]
Objects
- discoverable
broadcast availability for Distributed Search from other Splunk Servers
- dist-search
distributed searches to other Splunk Servers
- listen
reception of data to be indexed from other Splunk Servers
Default Parameter
- source
TCP port number on which to listen for data from other Splunk Servers - default is 8089
Required Parameters
- source
Optional Parameters
- auth
username:password to authenticate the command to a Splunk Professional server
Examples
# splunk enable listen
# splunk enable listen 18089
# splunk enable listen -source 18089 (same thing, since -source is the default parameter)
# splunk enable discoverable -auth gwb:d3cidr
This documentation applies to the following versions of Splunk: 2.1 , 2.2 , 2.2.1 , 2.2.3 , 2.2.6 View the Article History for its revisions.