Use the interface to manage apps

The main function of the interface is to create server classes that map deployment apps to agents. This process is described in the topic "Use agent management UI 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, go to the agent management interface, as described in "Access the agent management interface", and perform these actions:

  1. On the home page of agent management, on the left menu, select the Forwarders view and go to the Applications tab, where you'll see a list of all applications (apps).

  2. Select the three dots (Threepots.png) in the last column for that app.

    There are a few things you can do from here:
    • View details
    • Uninstall
    • Edit server class
    • Assign server class
Note: You cannot edit the actual content of the app from the agent management interface. To change its content, you must update the app through the agent management's file system, as described in Create deployment applications.

Uninstall an app

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

Uninstall an app from all server classes

To uninstall an app from all server classes, select the Uninstall option.

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

Uninstall an app from one server class

To uninstall an app from just one server class:

  1. Select the Edit server classes option. This takes you to the Edit server classes Assigned page, with two columns: Unassigned Server Classes and Assigned Server Classes, with a list of server classes under each.

  2. Locate the server class that you want to remove the app from under Assigned Server Classes.

  3. Select the server class name, then select the left arrow (Ra.png) to move it from the Assigned Server Classes column to the Unassigned Server Classes column.

  4. Select Save.

The agent management removes the app from all agents in that server class.

View the app deployment status

To view the deployment status of an app:

  1. On the home page of agent management, on the left menu, select the Forwarders view and go to the Applications tab, where you'll see a list of all apps.

  2. Locate the Deployment status column. The column indicates how many agents have received the app.

For more information, select the app name. This takes you to a screen that shows a summary of information about the app, as well as the app's agents and their deployment status.

Edit app settings for post-delivery behavior

You can also modify your application settings for post-delivery behavior:

  1. On the home page of agent management, on the left menu, select the Forwarders view and go to the Applications tab, where you'll see a list of all apps.
  2. Select the application you would like to modify. This takes you to the Details page for that application.

Under Settings, you can now modify your application settings for post-delivery behavior. By default, the application is set to be enabled after delivery, but you can also choose to disable it, or for your application not to run on your agent. Lastly, you can select whether or not to restart your agent after delivery.

Preview application content

Preview the contents of applications before you roll them out. You can browse the app file structure, review configuration files, without logging in to the deployment server host or manually browsing the file system.

Preview the contents of applications before you roll them out. You can browse the app file structure, review configuration files, without logging in to the deployment server host or manually browsing the file system.
  1. On the home page of agent management, on the left menu, select the Forwarders view and go to the Applications tab, where you'll see a list of all applications.
  2. In the table, select the application that you want to inspect.
  3. On the application page, select the Content.

When the content previewer loads, the screen is split into the following sections:

  • A file tree in the left sidebar.
  • A file content pane on the right where file contents or messages are displayed.

Now you can select elements in the file tree and view their content in the content pane.

How the previewer handles content

The content previewer shows file content so that what you see in Splunk Web closely matches the actual file on disk.

Browse the app structure

When you open the Content tab on the application page:

  • The application directories and files are displayed as a hierarchical tree.
  • You can expand and collapse folders to explore the app structure.
  • Selecting a file in the tree opens it in the file content pane.

If the app contains symbolic links (symlinks):

  • Symlink entries are marked as non‑previewable.
  • Clicking a symlink does not load any content in the file content pane.

See which files changed

Files that were modified after the last reload timestamp display a modified dot icon next to the file in the tree. Use this indicator to quickly focus on files that might need review before redeploying an app.

Automatic README selection

If the application contains a README file, this README opens first when you select the Content tab.

Empty app and no previewable files

The content previewer distinguishes between different empty states:

  • If the app directory contains no files or folders at all, the content previewer shows an empty directory error message.

  • If the application contains only subdirectories and no regular files:

    • The file tree shows the folder structure.
    • The file content pane shows a no previewable files message.

      This tells you that the app structure exists, but there is nothing that can be rendered as a file in the content pane.

  • If the application contains files that cannot be previewed, such as PNG files, the message indicates that the file type is unsupported.