# 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](#prerequisites)
- [Installing FSO agent on Windows](#installing-fso-agent-on-windows)
- [Installing FSO agent on Linux](#installing-fso-agent-on-linux)
- [Bulk installation of FSO agent on multiple hosts](#bulk-installation-of-fso-agent-on-multiple-hosts)
- [Starting and stopping the FSO agent](#starting-and-stopping-the-fso-agent)
- [Upgrading 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](https://www.manageengine.com/products/applications_manager/help/agent-monitoring.html) 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](https://www.manageengine.com/products/applications_manager/server-agent-installation.html).
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](https://www.manageengine.com/products/applications_manager/help/verifying-sha256-checksum.html) (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):

```bash
# 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:

```bash
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:

```bash
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)](https://www.manageengine.com/products/applications_manager/help/fso-agent-bulk-installation-windows.html#ad)
- [Custom scripts](https://www.manageengine.com/products/applications_manager/help/fso-agent-bulk-installation-windows.html#custom)
- [During agent installation](https://www.manageengine.com/products/applications_manager/help/fso-agent-bulk-installation-windows.html#agent)
- [Via System Center Configuration Manager (SCCM)](https://www.manageengine.com/products/applications_manager/help/fso-agent-bulk-installation-windows.html#sccm)
- [Via ManageEngine Endpoint Central](https://www.manageengine.com/products/applications_manager/help/fso-agent-bulk-installation-windows.html#ec)

### Linux

- [Via ManageEngine Endpoint Central](https://www.manageengine.com/products/applications_manager/help/bulk-install-fso-linux-agent-endpoint-central.html)

## 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 for Windows displayed at the bottom right corner of the Windows screen and click on **Start Agent**, **Stop Agent**, or **Restart Agent** 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:

```bash
# 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](https://www.manageengine.com/products/applications_manager/help/manage-agent.html#upgrade).