Forwarder management overview
The forwarder management interface is an interactive, visual tool for creating server classes, which map deployment clients to deployment apps. You can also use forwarder management to manage and monitor your deployment.
The interface saves server class configurations to a serverclass.conf file, located under
$SPLUNK_HOME/etc/system/local on the deployment server.
Capabilities of the interface
The main purpose of the forwarder management interface is to create and edit server classes. You can also use it for a number of other purposes:
- To track the status of the system
- To monitor deployment activity
- To view the associations between apps, clients, and server classes
- To configure app behavior
- To uninstall apps from clients
Access the forwarder management interface
You access the forwarder management interface through Splunk Web on the deployment server. To open the interface:
1. Click the Settings link at the top of Splunk Web. A window pops up with links to the set of system interfaces.
2. Select "Forwarder Management" in the Distributed Environment section. This takes you to the main page of the interface.
The following example shows the forwarder management home page as it might appear when you already have some apps, clients, and server classes:
The page contains these features (going from top to bottom):
- The Repository Location. The repository location is where deployment apps reside on the deployment server.
- A status section, with information on deployment clients and recent downloads.
- Three tabs:
- Apps. This tab lists the set of deployment apps in the repository location, along with their status. You can edit some app properties from here.
- Server Classes. This tab lists the set of server classes, along with their status. From here, you can create new server classes and edit existing ones. You can also drill down on existing server classes for information on their associated apps and clients. For a new, unconfigured deployment server, the list will be empty.
- Clients. This tab lists all of the deployment server's clients, along with status information. You can filter this list in various ways to limit the current view.
For more information on this page, read "Use forwarder management to define server classes".
Limitations of the interface
The forwarder management interface supports the vast majority of deployment server use cases. For some complex configuration requirements, however, you might need to edit
Important: If you switch from forwarder management to direct editing of
serverclass.conf, you might not be able to use forwarder management for any subsequent configuration. This is because the forwarder management interface can handle only a subset of the configurations possible through
Here are some limitations of the interface, compared to direct editing of the configuration file:
- Deployment behavior of any app must be the same across server classes. For example, you cannot specify that an app initiate a restart on a client when it's downloaded via one server class but not when it's downloaded via another server class.
- You cannot modify the default
repositoryLocationon the deployment server.
filterType, which governs the combined behavior of whitelists and blacklists, must use the default value of
- Client filters are only supported at the server class level.
For details on forwarder management limitations and compatibility between forwarder management and
serverclass.conf, see the topic "Compatibility and forwarder management".
How deployment updates happen
Plan a deployment
This documentation applies to the following versions of Splunk® Enterprise: 6.0, 6.0.1, 6.0.2, 6.0.3, 6.0.4, 6.0.5, 6.0.6, 6.0.7, 6.0.8, 6.0.9, 6.0.10, 6.0.11, 6.0.12, 6.0.13, 6.0.14, 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.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.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.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.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, 7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.1.0, 7.1.1