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 both Windows and Linux environments and transmits the collected data securely 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.

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

• Prerequisites
• Installing FSO agent on Windows
• Installing FSO agent on Linux
• Bulk installation of FSO agent on multiple hosts
• Starting and stopping the FSO agent
• Upgrading the FSO agent

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 addtion, ensure that the requirements listed in this page are also met before proceeding to install the FSO agent.

Installing FSO agent on Windows

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

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) file by clicking the Download for Windows button shown on the screen. Alternatively, you can do so by downloading and extracting the FSO agent package from the FSO agent download page.
4. Double-click the downloaded .msi file to launch the installation wizard.
5. Follow the on-screen instructions to proceed with the installation.
6. During the installation, provide the following details by copy-pasting the values from the screen:
   • Device Key — Enter the unique device key generated from Applications Manager.
   • Hostname — Specify the hostname or IP address of the Applications Manager server.
   • Port — Enter the SSL port used by Applications Manager (default: 9099).
7. Continue following the installation wizard prompts to complete the installation process.
8. Once the installation is complete, open Applications Manager and navigate to Settings -> FSO Agent -> View Agents to view your newly-added FSO monitor agent for Windows.

Installing FSO agent on 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 5 directly.

Follow the steps below to install and configure the Applications Manager 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) file by clicking the Download for Linux button shown on the screen. Alternatively, you can do so by downloading and extracting the FSO agent package from the FSO agent download page.
   • After downloading, perform a checksum verification (optional but recommended) to ensure integrity of the downloaded agent file.
4. 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):
   //Using CLI command 
sudo unzip ApplicationsManager_FSO_Agent.zip 

//Using PowerShell command 
Expand-Archive -Path ".\ApplicationsManager_FSO_Agent.zip" -DestinationPath "."
5. Enable AppLogs monitoring (Optional) if you want to collect and monitor application log data from the server.
6. To install the agent on the target server to be monitored, download the installation script using the following command in a command terminal:
   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:

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

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

• Active Directory (AD)
• Custom scripts
• During agent installation
• Via System Center Configuration Manager (SCCM)
• Via ManageEngine Endpoint Central

Linux

• Via ManageEngine Endpoint Central

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-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 option 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 command terminal based on the user type and directory location:

Upgrading the FSO agent

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