Foglight Agent Manager 5.9.7 - Foglight Agent Manager Guide

Configuring the embedded Agent Manager

This guide provides instructions for installing, configuring, and starting the Foglight® Agent Manager. Before you begin, refer to the Foglight System Requirements and Platform Support Guide, and the Foglight Installation and Setup Guide set.

This guide provides installation instructions for both Windows® and UNIX® operating systems. Commands are listed separately for each OS. Generic examples follow the UNIX path structure that uses forward slashes '/' to separate directories; substitute the back slash where necessary for your operating system.

Getting started

An instance of the Foglight® Agent Manager is automatically installed with new installations of the Foglight Management Server. This embedded Agent Manager instance runs on the Management Server machine. You can deploy agents to the embedded Agent Manager if you want to monitor the machine on which the Management Server runs.

In certain environments, Foglight starts and stops the embedded Agent Manager along with the Management Server by default. You can configure whether or not you want the embedded Agent Manager to run in tandem with the Management Server.

NOTE: Although the Agent Manager Adapter cartridge is installed by default with the embedded Foglight, you must still install a Foglight cartridge that contains installers for your supported platforms in order to deploy the Agent Manager to remote hosts. See “Installing External Agent Managers” on page 11 for information about selecting a Agent Manager cartridge, downloading installers, installing, configuring, and running the Agent Manager.

By default, Foglight starts and stops the embedded Agent Manager along with the Management Server when the Management Server is installed in standalone mode.

The embedded Agent Manager does not start automatically when:

CAUTION: The fglam --create-state and fglam --location command-line options are not recommended for use with the embedded Agent Manager. For more information, see Configuring multiple Agent Manager instances.

If you are running the Management Server as a Windows® service, the embedded Agent Manager continues to run when you log out of the machine on which the embedded Agent Manager and the Management Server are running.

An embedded instance of the Agent Manager automatically installs with the Management Server. You can deploy agents to the embedded Agent Manager. You can specify whether or not the embedded Agent Manager runs in tandem with the Management Server by changing the value of the server.fglam.embedded parameter in the server.config file.

Interacting with the embedded Agent Manager

You can run the configuration interface from the embedded Agent Manager installation directory, <foglight_home>/fglam/bin.

IMPORTANT: On UNIX® platforms, if you attempt to run the installation interface, and the DISPLAY environment variable is not set on the machine, the Agent Manager defaults to the command-line interface.

Automatic configuration of the Management Server host name and port number

The embedded Agent Manager only communicates with the Management Server that starts it (the Management Server with which it was installed).

When configuring the embedded Agent Manager, you do not need to set the host name and port number of the Management Server with which it communicates. The embedded Agent Manager automatically sets the host name and port number of the Management Server that starts it in its configuration file, fglam.config.xml, which is located in the <foglight_home>/fglam/state/default/config/ directory.

If you configure a host name and port for a different Management Server, these settings are overwritten when the embedded Agent Manager starts.