Schedule demo

FSO Agent Installation


The FSO (Full Stack Observability) Agent is a lightweight component that runs on target hosts to collect system-level metrics, application performance data, and log information. It supports Windows and Linux environments and securely transmits collected data to Applications Manager for processing, visualization, and analysis. Installing the FSO Agent enables detailed, real-time monitoring with minimal overhead and reduced dependency on remote polling.

Note: The information on this page only applies to Applications Manager build 182900 and later . For builds earlier than 182900, refer here.

Browse the following topics to install the FSO agent on various environments:

Prerequisites

Ensure the following requirements are met before proceeding with the agent installation:

  • Administrative Privileges: The user performing the installation must have administrator-level access on the target system.
  • SSL Port Availability: A dedicated SSL port must be configured in Applications Manager for agent communication. Ensure that this port is open and accessible between the agent host and the Applications Manager server.

In addition, ensure that the requirements listed on this page are also met before proceeding to install the FSO agent.

Installing the FSO agent

Applications Manager generates an install command that already contains your license key and the server address. Run this command on the target server to install the agent. After the command runs, the server is added to Applications Manager as a monitor automatically.

Navigate to New Monitor -> FSO Agent. The wizard has three steps: Select Platform, Agent Bundle & Capabilities, and Install Agent.

Step 1: Select platform

Select the operating system of the target server (Windows or Linux) and click Next.

 Select Platform step of the FSO Agent wizard showing the Windows and Linux options

Step 2: Agent bundle and capabilities (optional)

Note: This is an optional step. By default, Full-Stack Monitoring is enabled. To change the agent bundle or the capabilities, click Edit next to Agent Bundle & Capabilities.

 Agent Bundle and Capabilities step in edit mode showing the FSO Agent Bundle section with the Upload new bundle option and the Advanced Settings section with the Server Monitoring, AppLogs and APM Insight capabilities

FSO Agent Bundle

This section shows the agent bundle that Applications Manager uses to install agents, and provides the following options:

  • Bundle status: Shows the version of the bundle that is available in Applications Manager, for example, FSO Agent bundle 18.20.00 is already available in Applications Manager.
  • Upload new bundle: Allows you to upload a newer agent bundle, as described below.

    Steps to upload a newer bundle for FSO agent installation
    1. Download the latest bundle for your Applications Manager version from the FSO agent download page.
    2. Click Upload new bundle.
    3. Drag the file onto the drop zone or click Choose File.
    4. Click Upload FSO Bundle. Applications Manager uploads the file and verifies it.

    Caution: Uploading a new bundle replaces the existing FSO agent binaries on the Applications Manager server. Agents that you deploy or upgrade from then use the new bundle.

Capabilities

The Advanced Settings section lists the supported capabilities: Server Monitoring (always enabled), AppLogs, and APM Insight. Clear the checkbox for any optional capability that you do not need. For more information about the capabilities, refer to Agent monitoring.

Step 3: Install agent

Copy the command shown on the page and run it on the target server (the server that needs to be monitored).

Important: Always copy the command from the Install Agent step. The command contains your license key and registration ID, so treat it as confidential.

 Install Agent step for Windows showing the target server address, the PowerShell install command with the Copy button, and the waiting status

Note: Check the Applications Manager address. The info bar shows the address that the agent will connect to, for example https://<apm-server-host>:10102. If the target server needs a different address, such as a host name, IP address, or NAT or proxy address, click Edit, change the Host or Port, and click Save. Saving regenerates the command.

  1. Click Copy above the command to copy it.
  2. Run the command on the target server:
    • Windows: Paste the command into an elevated PowerShell window (Run as administrator).
    • Linux: Run the command as root or with sudo in a shell.
  3. Wait for the agent to register. The wizard shows Waiting for the command to run on the target server with a timer. Keep the page open, as it updates automatically when the agent connects. The progress moves through Execution, Installation, and Installation Complete. When the agent registers, the wizard shows Agent onboarded successfully.

     Install Agent step showing the Agent onboarded message successfully

  4. Click Complete or Go to View Agents. For details on viewing and managing the agents, refer to Verifying the agent.

If the agent does not register

The agent usually registers within a minute after the command finishes. If no agent has registered after about five minutes, the wizard shows No agent has reported yet. In this case:

  • Check that the command ran without errors in an elevated PowerShell window (Windows) or as root or with sudo (Linux).
  • Check that the target server can reach the Applications Manager address on the agent port.
  • Click Check again or open the Troubleshooting guide.

Verifying the agent status

Open the View Agents tab. The new server appears in the list, and its status changes to Active once the agent is connected and sending data. For details on agent statuses and management capabilities, refer to Manage FSO agents. To view agent details, configure AppLogs and APM Insight, or check agent health, refer to FSO Agent Configuration.

 View Agents tab listing the installed agent with its status, IP address, version, OS and capabilities

Bulk installation of FSO agent on multiple hosts

Browse the following links to install FSO agents on multiple servers and hosts for the respective OS:

Windows

Linux

Starting and stopping the FSO agent on the target (monitored) server

Once the installation is complete, you can start, stop, or restart the FSO agent for the respective OS using any one of the following methods:

Note: You can start, stop, or restart the agent from the Applications Manager console, on the FSO Agent Configuration page. Use the steps below only when there is a communication issue between the agent server and the Applications Manager server. In that case, start or stop the agent directly on the target server.

Windows

  • Agent tray icon: Right-clicking the FSO agent tray icon for Windows, displayed at the bottom-right corner of the Windows screen, and click on Start Agent, Stop Agent, or Restart Agent options, respectively, to perform the required actions.
  • Using Windows Services: Execute the services.msc command from Start menu -> Run and select the required actions (Start, stop, or restart) after right-clicking the FSO agent service for Windows.

Linux

Execute the following commands in the command terminal based on the user type and directory location:

# FOR AGENT INSTALLATION VIA ROOT USER

#1 For starting the Linux Agent
/opt/applicationsmanager/monagent/bin/monagent start

#2 For stopping the Linux Agent
/opt/applicationsmanager/monagent/bin/monagent stop

#3 For restarting the Linux Agent
/opt/applicationsmanager/monagent/bin/monagent restart

#4 For checking the status of Linux Agent
/opt/applicationsmanager/monagent/bin/monagent status


# FOR AGENT INSTALLATION IN CUSTOM PATH

#1 For starting the Linux Agent
[custom_path]/monagent/bin/monagent start

#2 For stopping the Linux Agent
[custom_path]/monagent/bin/monagent stop

#3 For restarting the Linux Agent
[custom_path]/monagent/bin/monagent restart

#4 For checking the status of Linux Agent
[custom_path]/monagent/bin/monagent status 

Loved by customers all over the world

"Standout Tool With Extensive Monitoring Capabilities"

★★★★★

It allows us to track crucial metrics such as response times, resource utilization, error rates, and transaction performance. The real-time monitoring alerts promptly notify us of any issues or anomalies, enabling us to take immediate action.

Reviewer Role: Research and Development

carlos-rivero
"I like Applications Manager because it helps us to detect issues present in our servers and SQL databases."
Carlos Rivero

Tech Support Manager, Lexmark

Trusted by thousands of leading businesses globally