Installing Foglight Agent Manager

You can install Foglight Agent Manager (FglAM) on Linux and Windows environment.

Windows FglAM installation

To install FglAM on Windows, perform the following steps:

1. Log in to Foglight Cloud by providing your credentials. This will direct you to the Foglight Welcome page. In the Download agent manager section, click For Windows to download and install agent manager for Windows.
   OR
   In the notification at the top of the Welcome page click Download and select Foglight Agent Manager for Windows. Save the file to a desired location on your system.
2. Copy the .zip file to the designated target machine and extract it there in preparation for installation procedure.

   Extract the file at the same location where you have copied it to avoid subsequent errors.

3. On the VM where the Agent Manager will be installed, run the FglAM--windows-x86_64.exe as an administrator. This will launch the Foglight Agent Manager Installation and Configuration wizard.
4. On the License Agreement screen, select the I accept the terms of license agreement checkbox, and click Next to proceed.
5. Select the desired Installation location for the Agent Manager files and provide a Host Display name. Click Next.
6. On the Confirm dialog box, click Yes, if the directory does not exist.
7. On the Server URLs screen, select the displayed server URL and click Test to verify the connection. Once a green tick appears indicating a successful connection, click Next to proceed.
8. On the Downstream Connection Configuration screen click Next to continue without making any changes.
9. On the Windows service screen select the checkboxes for desired service configuration options and click Next.
10. On the Summary screen review the summary of the installation settings. If everything appears correct, click Finish to complete the installation process.

By following these steps, you will successfully download, install, and configure the Foglight Agent Manager on a Windows environment.

In Foglight, navigate to Administration > Agents > Agent Managers in the left pane to view the installed FglAM.

Linux FglAM installation

To install FglAM on Linux, perform the following steps:

1. Log in to Foglight Cloud by providing your credentials. This will direct you to the Foglight Welcome page. In the Download agent manager section, click For Linux to download and install agent manager for Linux.
   OR
   In the notification at the top of the Welcome page click Download and select Foglight Agent Manager for Linux.
2. Copy the FglAM bin file to the designated target machine and download it on the required virtual machine (VM).
3. Set appropriate permissions to the .bin file by using the command: chmod 755 %FGLAM_BIN_FILE%.
4. Execute the .bin file with the command: ./%FGLAM_BIN_FILE%. For example: ./FglAM-<version>-linux-x86_64.bin.
5. Press the ENTER key till the end of the “terms of agreement” section.
6. Press Y to accept the terms of license agreement.
7. Specify the desired location for the installation folder and press Enter.
8. Provide a Host Display Name for the Agent Manager and press Enter.
9. To log a warning if the detected host name changes, press Y.
10. Press 5 to view the list of configured management server URLs.
11. Press 3 for connectivity test. Ensure that the connectivity test shows 100% completion with a status of “finished”.
12. Press 0 to continue with the default values for the remaining prompts.
13. When prompted for “Enable Concentrator Support”, press Enter to select the default value.
14. To customize the start-up script, press Y.

By following these steps, you will successfully install the Foglight Agent Manager on a Linux environment.

In Foglight, navigate to Administration > Agents > Agent Managers in the left pane to view the installed FglAM.

Uninstalling Foglight Agent Manager

This section describes the steps to completely uninstall the Agent Manager and remove the init.d script used to run the Agent Manager as a daemon or the Foglight Agent Manager Windows service.

To remove the init.d script or systemd service used to run the Agent Manager as a daemon on Linux:

1. Launch a command shell on the Agent Manager machine and navigate to {FGLAM_HOME}/state/default/.

2. Switch to the root user and stop the Agent Manager:

   • If you are using System V init scripts, then run /etc/init.d/quest-fglam stop
   • If you are using systemd services, then run systemctl stop quest-fglam

3. Switch to the root user and run the fglam-init-script-installer.sh script with the remove option: ./fglam-init-script-installer.sh remove

If you are using System V init scripts, then the fglam-init-script-installer.sh script will remove the quest-fglam init.d script and all known symlinks to the quest-fglam script. If you are using systemd services, then the fglam-init-script-installer.sh script will disable and remove the quest-fglam service.

To remove the Foglight Agent Manager Windows service:

1. Launch a Command Prompt window on the Agent Manager machine and navigate to the {FGLAM_HOME}\bin directory

2. Run the Agent Manager from the command-line with the –remove-service option: fglam.exe --remove-service

3. Close the Command Prompt window.

To uninstall the Agent Manager:

1. Stop the Agent Manager.
2. Delete the installation directory ({FGLAM_HOME}) and any state directories related to this installation.

Delete the Agent Manager topology objects in Foglight Cloud

Foglight Cloud might still generate alarms about the FglAM (Agent Manager) that was just uninstalled.

To prevent this, you need to delete the FglAM using the Disconnected Agent Managers dialog from the Agent Managers dashboard.

1. Navigate to Administration > Agents > Agent Managers
2. Click the link for Disconnected Agent Managers (N)
3. Select the FglAM that has already been decommissioned.
4. Click Delete Agent Manager.