Foglight 5.9.8 - Command-Line Reference Guide

About the Command-Line Interface

This Command-Line Reference Guide provides information about the Foglight® command-line interface. You can use Foglight commands to interface with different components of your monitoring environment instead of the browser interface.

This guide is intended for Foglight System Administrators who are new to Foglight can find information about syntax conventions along with an overview of all Foglight commands in the first chapter of this guide. The following chapters contain reference information about specific commands, such as the Foglight Management Server and Foglight Agent Manager commands. Advanced users can find information about the fglcmd interface in the last chapter. The last chapter contains information about the commands that provide administrative-level commands. Read this chapter to find out how to deploy and create agents, install and activate cartridges, manage licenses, and do many other administrative tasks from the command line.

This manual describes the commands that come with your Foglight installation and allow you to access different components in your monitoring environment without having to use the standard graphical interface such as the Administration dashboards. This can be useful in situations when you need to either automate your business logic by writing scripts, or use regular expressions to select multiple entities where applicable.

This manual employs a set of conventions that are used in the command syntax. You should review them before getting started with the manual in order to successfully make use of Foglight commands in your monitoring environment. The syntax conventions are as follows:

Looking at Foglight Commands

Foglight provides a number of commands that you can use to manage different components in your monitoring environment. The commands reside in the following directories of your Foglight Agent Manager or Foglight Management Server installation.

For more information about the <foglight_home> and <foglight_agent_mgr_home> placeholders, see Syntax Conventions .

The following table lists Foglight commands.

Getting Started with Foglight Commands

NOTE: These instructions describe a simple configuration in which the Foglight™ Management Server and the Foglight Agent Manager are installed on the same platform.

From here, you can proceed to any of the following , as required:

Managing the Foglight Management Server

Foglight offers a set of commands that allow you to perform server-related operations through the command-line interface. You can use these commands to perform a variety of tasks, such as start or stop the Foglight Management Server, run or upgrade the database, or manage encryption keys.

The majority of server-specific commands access the server directly. As such, you can only issue them on the computer that is running an instance of the Foglight Management Server. One exception is the Remote Monitor utility that you can use to communicates with multiple instances of the Foglight Management Server running in High Availability (HA) mode. For more information about running the Foglight Management Server running in HA mode, see fmsha .

Your Foglight installation includes a compressed file, <foglight_home>/tools/remotemonitor.zip, that contains the Remote Monitor utility. If required, you can extract the contents of that file to a remote computer in your Foglight network and run the Remote Monitor utility from that computer, as described in To get started with Foglight Management Server commands: . For information about the location of foglight_home, see Syntax Conventions .