Foglight 5.9.1 - Installing Foglight on a UNIX System with an External MySQL Database

Installing and Upgrading Cartridges

Using the Foglight Administration Module, you can install cartridges on the machine hosting the Management Server, enable and manage cartridges, and download agent installers.

The Cartridge Inventory dashboard contains controls for installing, enabling, disabling, and uninstalling cartridges, and for viewing information about the installed cartridges.

Installation is the first step in adding a cartridge to the Management Server. A cartridge file has the extension .car. Installing the .car file causes the Management Server to be aware of all cartridges in the .car file.

A cartridge must also be enabled before it is added to the Management Server. You can choose to enable a cartridge during installation, or afterward. See the Administration and Configuration Help for instructions on enabling and disabling cartridges after installation.

If the installation is successful, the message “Cartridge has been installed successfully” appears in the Install Cartridge area and the cartridge is listed in the Cartridge Inventory.

If Enable on install was not selected (see Step 4), a disabled symbol () appears in the row for that cartridge in the Installed Cartridges table on the Cartridge Inventory dashboard.

For more information about cartridge installation and configuration, see the Administration and Configuration Guide.

NOTE: Warning messages similar to the following appear in the Management Server log when you install a cartridge: WARN — Module system:<name> was converted to the newest version during loading These warnings are expected and do not affect functionality.

To obtain a full list of the cartridges installed on the Management Server, open the Cartridge Inventory dashboard (Administration > Cartridges > Cartridge Inventory), and select Cartridge Inventory Report from the Reports menu.

For complete cartridge upgrade instructions, see the Upgrade Guide.

Installing Agents

A cartridge may include one or more executable Foglight agent installers. The agent installers included in a cartridge are listed on the Components for Download dashboard (on the navigation panel, select Administration > Cartridges > Components for Download).

Agents must be installed on all the machines you want to monitor. For agents that are installed on the monitored host, you must install and configure the Agent Manager.

NOTE: Foglight 4-converted agents create two processes for themselves when activated by the Agent Manager.

For more details, see these topics:

Agent installers

Agents that depend on the Agent Manager are installed using the remote installation procedure. See Remote agent installation and the Administration and Configuration Guide.

Some cartridges Foglight include one or more executable agent installers. The agent installers that are available for download are listed on the Components for Download dashboard. You can use the controls on this dashboard to download agent installers from the Management Server to a remote machine.

NOTE: For agents that are installed individually, run the agent installer executable and set up the agent on each machine you want to monitor with that type of agent. The Agent Manager defines agents with their Agent Package name. When displayed in the Create Agent dialog, the agent names are prepended with the cartridge name.

Depending on the type of agent that you installed, you may need to edit its properties to configure it for the part of your environment that you want to monitor. For information about agent properties, see the Administration and Configuration Guide and the User Guide for the cartridge with which the agent was included.

Remote agent installation

You can install Foglight agents on any remote host on which the Agent Manager is installed. See the Agent Manager Guide.

For more information about remote agent installation, see the Administration and Configuration Guide.