Foglight 5.9.2 - Command-Line Reference Guide

You can issue the administrative commands on the computer running the Foglight Management Server, or on a remote computer in your network. Your Foglight installation includes a compressed file, fglcmd.zip, that contains all of the administrative commands. To get started, make sure you have the Foglight Management Server and Foglight Agent Manager running, and, if you are planning to access the administrative interface remotely, copy and extract the contents of the compressed file to your remote computer.

To get started with administrative commands:


	NOTE: This procedure continues from Getting Started with Foglight Commands .

If you want to use the fglcmd interface on a remote computer in your monitoring network, complete the following steps:

Copy the <foglight_home>/tools/fglcmd.zip file from the computer that has a running instance of the Foglight Management Server to the remote computer, where foglight_home refers to the installation directory of the Foglight Management Server.

Extract the contents of the fglcmd.zip file to the remote computer.

Specify the directory that contains the Foglight Management Server commands, either <foglight_home>/bin or the directory on the remote computer (see Step 1), by completing one of the following steps.

•

If you want to use the command prompt, open a Command Prompt window (Windows®) or a terminal window (UNIX® or Linux®) and navigate to the appropriate directory.

•

If you want to use a Foglight Management Server command in a script, ensure that your script references the appropriate directory.

For more information about foglight_home, see Syntax Conventions .

Foglight Management Server enables only the HTTPS port for remote access, and installs a self-signed certificate. The security certificate allows the server to communicate with a remote machine through the HTTPS protocol. If you intend to use the administrative commands either on a remote computer, or on a Foglight Management Server computer through the HTTPS protocol, you need to export the security certificate from the Foglight Management Server, and import it into your JRE environment, as described below.


	IMPORTANT: The commands below follow the generic syntax in which forward slashes '/' are used to separate directories. On Windows platforms, instead of forward slashes '/', use back slashes ‘\’ as directory separators in file paths. For more information about the syntax conventions used in this manual, see Syntax Conventions .

Export the security certificate from the Foglight Management Server.

On the computer on which a Foglight Management Server is running, open a Command Prompt window (Windows) or a terminal window (UNIX® or Linux®) and navigate to <foglight_home>/jre/bin, followed by issuing the following command:

keytool -exportcert -keystore foglight_home/config/tomcat.keystore -alias tomcat -file filename -storepass nitrogen

Where filename is the name of the file in which the command stores the security certificate.

Import the security certificate into your environment, either on the remote computer, or on the computer on which the Foglight Management Server is running.

On the computer on which you intend to use the administrative commands, open a Command Prompt window (Windows) or a terminal window (UNIX® or Linux®) and navigate to <jre_home>/bin, followed by issuing the following command:

keytool -importcert -file filename -alias foglightcert -keystore ../lib/security/cacerts -storepass changeit

Where filename is the name of the file to which you exported the security certificate in Step a.


	IMPORTANT: The default keystore password for jre/lib/security/cacerts is changeit.

Issue one or more administrative commands using command prompt or a script. From here, you can issue any fglcmd commands described in the following , as required.

See also

•

Managing Agents, Cartridges, and Metrics

•

About Regular Expressions

•

Running Administrative Commands: Example

•

Looking at Scope-Specific Commands

•

Listing Administrative Commands

Running Administrative Commands: Example

In this example, you will issue an administrative command that lists the agent packages that can be deployed to the Foglight Agent Manager using the packages command. The syntax of the packages command is as follows:

fglcmd connection_options -cmd agent:packages options

For more information about the command syntax, see Managing Agents, Cartridges, and Metrics .

In this example, you will issue the packages administrative command to list all Foglight Agent Manager instances and the agent packages that can be deployed to each Agent Manager instance.

To list agent packages:


	NOTE: This procedure continues from “Getting Started with Foglight Commands .

•

In the Command Prompt window (Windows®) or the terminal window (UNIX® or Linux®), type the following command:

fglcmd -usr foglight -pwd foglight -cmd agent:packages -allclients

A list of all available agent packages appears in the Command Prompt or terminal window. A sample of that output is similar to the following listing:

Client ID: Host1-2d2edfcc#be05acc0-6179-4878-a274-afcd5075260a

Agent Package ID: HostAgents-5.9.2-Host Agents

Agent Package Cartridge Name: HostAgents

Agent Package Cartridge Version: 5.9.2

Agent Package Version: 5.9.2

------------------------------------

Client ID: Host2.example.com#6290d00c-8fd6-42a3-bc2a-63b0d5263645