Use forwarder management to manage apps

The main function of forwarder management is to create server classes that map deployment apps to clients. This process is described in the topic "Use forwarder management to define server classes".

The interface also provides tools to manage deployment apps. You can:

• Edit an app
• Uninstall an app
• View app deployment status

Edit an app

To edit an app:

1. Go to the Apps tab, where you'll see a list of all apps.

2. Find the app you want to edit and click its Edit action.

3. Select the Edit option. This takes you to the Edit App screen for that app.

There are a few things you can do from here:

• Add the app to a new server class or delete it from an existing server class. On the upper part of the screen, there's a section called Server Classes. Click the + button to add the app to a new server class. Click the x to the right of a server class to remove the app from a server class.

• Specify the behavior that occurs immediately after a deployment client downloads the app. There are two options:
  • Enable App. This enables the app on the client.
  • Restart Splunkd. This restarts splunkd on the client.

When you have finished with your changes, click the Save button. This will cause the deployment server to save the changes and redeploy the app (as well as any other apps that have been updated in the interim). For details on how app deployment occurs, see "Deploy apps to clients".

Important: You cannot edit the actual content of the app from the forwarder management interface. To change its content, you must update the app through the deployment server's file system, as described in "Create deployment apps".

Uninstall an app

You can uninstall an app from all server classes or from just a single server class.

Uninstall from all server classes

To uninstall an app from all server classes:

1. Go to the Apps tab, where you'll see a list of all apps.

2. Find the app you want to edit and click its Edit action.

3. Select the Uninstall option.

This action removes the app from all server classes and uninstalls it from all clients. It does not actually remove the app from the deployment server's file system.

Uninstall from one server class

To uninstall an app from just one server class:

1. Go to the Server Classes tab, where you'll see a list of all server classes.

2. Find the server class from which you want to remove the app, and click its Edit action.

3. Select the Edit Apps option. This takes you to the Edit Apps page. On the Edit Apps page, there are two columns: Unselected Apps and Selected Apps, with a list of apps under each.

4. Locate the app that you want to uninstall in the Selected Apps column.

5. Click the app name to move it from the Selected Apps column to the Unselected Apps column.

6. Click Save.

The deployment server removes the app from all clients in that server class.

View app deployment status

To view the deployment status of an app:

1. Go to the Apps tab, where you'll see a list of all apps.

2. Locate the Clients column. The column indicates how many clients have received the app.

For more information, click on the app name. This takes you to a screen that shows a summary of information about the app, as well as the app's clients and their deployment status. You can click on the arrow to the left of each client column to see the apps and server classes that the client is associated with.