Schedule demo
Home

FSO Agent Installation

Applications Manager supports agent-based monitoring using the FSO (Full Stack Observability) Agent. The FSO Agent is a lightweight component installed on the target server to collect detailed performance metrics and logs from servers and applications. The FSO Agent collects data locally and securely transmits it to the Applications Manager server, providing enhanced visibility and reliability in monitoring.

Key components of agent-based monitoring

The FSO Agent consists of multiple sub-agents that work together to provide comprehensive monitoring:

  • Server monitoring — Collects system-level performance metrics such as CPU, memory, disk, and processes. (Supported from v176300)
  • Application Logs (AppLogs) monitoring — Monitors application logs and helps in log analysis and troubleshooting. (Supported from v179400)
  • Application Monitoring (APMInsight) — Provides end-to-end application performance monitoring with transaction tracing, error diagnostics, and performance bottleneck detection. (Supported from v181100)

Browse through 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 (default: 10099). Ensure that this port is open and accessible between the agent host and the Applications Manager server.
  • Hardware Requirements: Ensure that the target system meets the minimum hardware requirements for installing the FSO agent.

Installing the FSO agent

Windows

Follow the steps below to install and configure the Applications Manager FSO agent on a Windows machine (Server which needs to be monitored):

  1. In the Applications Manager console, navigate to Settings -> FSO Agent -> Deploy Agent.
  2. Choose Windows as the Operating System.

  3. Download the latest FSO agent installer for Windows (ApplicationsManager_Windows_Installer.msi) by clicking Download for Windows on the screen.

    Note:

    • By default, the agent installer (ApplicationsManager_Windows_Installer.msi) is bundled within the product and ready for installation. Alternatively, you can download and extract the latest FSO agent package from the FSO agent download page, then navigate to FSO/latest/server/windows/installer to locate the installer.
    • The agent installer (ApplicationsManager_Windows_Installer.msi) is sufficient for Server monitoring. To also monitor applications (APMInsight) or logs (AppLogs), download and extract the FSO agent package to get all the required binaries as follows:
    Steps to download and extract the FSO agent package
    1. Download the latest FSO agent package (ApplicationsManager_FSO_Agent.zip) from the FSO agent download page.
      • After downloading, perform a checksum verification (optional but recommended) to ensure integrity of the downloaded agent file.

    2. Copy the downloaded .zip file under <Applications Manager Home>\working\resources\ directory and extract the contents using the following command (run in administrator/root mode):

      //For Linux, using CLI command 
      sudo unzip ApplicationsManager_FSO_Agent.zip 

      //For Windows, using PowerShell command 
      Expand-Archive -Path ".\ApplicationsManager_FSO_Agent.zip" -DestinationPath "."
  4. Move the downloaded ApplicationsManager_Windows_Installer.msi file to the target server that needs to be monitored, then double-click the file to launch the installation wizard.
  5. Follow the on-screen instructions to proceed with the installation.
  6. During installation, enter the connection details obtained from the Deploy Agent page:
    • Device Key — the unique device key used for agent communication.
    • Hostname — the hostname or IP address of the Applications Manager server.
    • Port — the SSL port used by Applications Manager (default: 10099).

  7. Continue following the installation wizard prompts to complete the installation process.

    Note: You can optionally enable Applications monitoring and AppLogs during installation if you want to collect and monitor application performance and logs from the server.
  8. Once the installation is complete, open Applications Manager and navigate to Settings -> FSO Agent -> View Agents to confirm your newly-added FSO monitor agent for Windows appears in the list.

Linux

Note: Check if the agent installation file is already available under the <Applications Manager Home>/working/resources/FSO/latest/server/linux/installer directory before proceeding. If the file is present, then start from Step 4 directly.

Follow the steps below to install and configure the Applications Manager FSO agent on a Linux machine:

  1. In the Applications Manager console, navigate to Settings -> FSO Agent -> Deploy Agent.
  2. Choose Linux as the Operating System.

  3. Download the latest FSO agent package for Linux (ApplicationsManager_FSO_Agent.zip) and extract it, as follows:

    Steps to download and extract the FSO agent package
    1. Download the latest FSO agent package (ApplicationsManager_FSO_Agent.zip) from the FSO agent download page.
      • After downloading, perform a checksum verification (optional but recommended) to ensure integrity of the downloaded agent file.

    2. Copy the downloaded .zip file under <Applications Manager Home>\working\resources\ directory and extract the contents using the following command (run in administrator/root mode):

      //For Linux, using CLI command 
      sudo unzip ApplicationsManager_FSO_Agent.zip 

      //For Windows, using PowerShell command 
      Expand-Archive -Path ".\ApplicationsManager_FSO_Agent.zip" -DestinationPath "."
  4. (Optional) Enable AppLogs and application performance monitoring (APMInsight) on the Deploy Agent page if you want to collect and monitor application log data and performance from the server.

  5. Copy the install command block shown on the Deploy Agent page and then paste and run it on the target server that needs to be monitored. Sample command:

     wget --no-check-certificate -O ApplicationsManagerFullStackAgent_LinuxIns.sh https://[TARGET-HOST]:[TARGET-PORT]/resources/FSO/latest/server/linux/installer/ApplicationsManagerFullStackAgent_LinuxIns.sh

    Then run the installation script containing the device key by executing the following command from the directory where the script file has been downloaded:

    Sample command:

    sudo -E bash ApplicationsManagerFullStackAgent_LinuxIns.sh -i -key=APMI_aaaaabbbbbbccccccdddddeeff -nocheckcert -automation=true -host=https://[TARGET-HOST]:[TARGET-PORT] -dpath=/resources/FSO/latest/server/linux/installer/
  6. Once the installation is complete, open Applications Manager and navigate to Settings -> FSO Agent -> View Agents to confirm your newly-added FSO monitor agent for Linux appears in the list.

Bulk installation of FSO agent on multiple hosts

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

Windows

Linux

Starting and stopping the FSO agent

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

Windows

  • Agent tray icon: Right-click the FSO agent tray icon displayed at the bottom right corner of the Windows screen, then select Start Agent, Stop Agent, or Restart Agent as required.
  • 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.(ManageEngine Applications Manager Full-Stack Agent)

Linux

Execute the following commands in 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

Upgrading the FSO agent

To learn how to upgrade the FSO agent to its latest version, refer here.

 

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