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.
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.
• Foglight is installed in High Availability (HA) mode. If you want to run the Agent Manager on the Management Server machines in your HA cluster, you must install, configure, and run separate (non-embedded) Agent Manager instances on these machines. See on page for instructions. For more information about High Availability mode, see the High Availability Field Guide.
• The Management Server is a Federation Master. The embedded Agent Manager does not start if you install Foglight as a Federation Master. See the Federation Field Guide for more information about federation.
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.To configure whether or not the embedded Agent Manager runs automatically with the Management Server:
2 On the Management Server machine, open <foglight_home>/config/server.config for editing.
3 Set the parameter server.fglam.embedded to the desired value:
• To have the embedded Agent Manager stop and start automatically with the Management Server, set server.fglam.embedded to true.
• To disable the embedded Agent Manager, set server.fglam.embedded to false.
4 Save your changes to the server.config file.
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.
4 Follow the appropriate set of instructions provided in or for proceeding through the configuration interface steps.Aside from setting the host name and port for the Management Server with which it communicates (described in below), you can configure the embedded Agent Manager as you would a standalone Agent Manager.
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.