Foglight 5.9.1 - Command-Line Reference Guide

Table 18. Options and arguments
Option	Argument	Description
allclients	None	Indicates that all instances of the Foglight Agent Manager should be selected.
clientbuild	build_ID	An explicit text string or a regular expression that selects one or more Foglight Agent Manager instances with the specified build ID.
clientid	client_ID	An explicit text string or a regular expression that identifies one or more instances of the Foglight Agent Manager.
clientname	display_name	An explicit text string or a regular expression that specifies one or more display devices that are running an instance of the Foglight Agent Manager.
clientversion	version	An explicit text string or a regular expression that selects one or more Foglight Agent Manager instances with the specified version.
connection_options		Specifies the user name and password for the Foglight Management Server, as well as the machine name and port number, if necessary. Alternatively, fglcmd can retrieve this information from a user-specific properties file. For more information on how to specify connection options on the command line, see Logging In and Setting the Scope . For details on using a properties file, see Using a Properties File to Supply Connection Information .
force	None	In cases where multiple client instances are selected, it indicates that all selected instances should be stopped.
host	host_name	An explicit text string or a regular expression that specifies one or more host names.
regex	None	Interprets the build_ID, client_ID, display_name, host_name, version, or upgradable arguments as regular expressions. For a sample regular expression used to specify a host name, see Example .
upgradable	true or false	Indicates whether one or more Foglight Agent Manager instances can (true) or cannot be upgraded (false). It can be set to a regular expression.

Example

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight

-cmd agent:logs -clientid Host1#be05acc0-6179-4878-a274-afcd5075260a

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

Client Name: Host1

Host Name: Host1

1 log files found.

C:\Quest\Foglight\fglam\state\default\logs\HostAgents\5.7.5.8\

WindowsAgent\Monitor@Host1_2011-11-21_151519_001.log

See also

•

getlog

logs

Listing and Retrieving Log Files

The logs command shows a list of agent log files.

For information on how to retrieve a log file using the fglcmd interface, see getlog .

Scope

agent

Syntax

fglcmd connection_options -cmd agent:logs {-clientname display_name|-clientid

client_ID|-clientbuild build_ID|-clientversion version|-allclients}

[-host host_name] [-regex] [-force] [-upgradable {true|false}]

Table 18. Options and arguments
Option	Argument	Description
allclients	None	Indicates that all instances of the Foglight Agent Manager should be selected.
clientbuild	build_ID	An explicit text string or a regular expression that selects one or more Foglight Agent Manager instances with the specified build ID.
clientid	client_ID	An explicit text string or a regular expression that identifies one or more instances of the Foglight Agent Manager.
clientname	display_name	An explicit text string or a regular expression that specifies one or more display devices that are running an instance of the Foglight Agent Manager.
clientversion	version	An explicit text string or a regular expression that selects one or more Foglight Agent Manager instances with the specified version.
connection_options		Specifies the user name and password for the Foglight Management Server, as well as the machine name and port number, if necessary. Alternatively, fglcmd can retrieve this information from a user-specific properties file. For more information on how to specify connection options on the command line, see Logging In and Setting the Scope . For details on using a properties file, see Using a Properties File to Supply Connection Information .
force	None	In cases where multiple client instances are selected, it indicates that all selected instances should be stopped.
host	host_name	An explicit text string or a regular expression that specifies one or more host names.
regex	None	Interprets the build_ID, client_ID, display_name, host_name, version, or upgradable arguments as regular expressions. For a sample regular expression used to specify a host name, see Example .
upgradable	true or false	Indicates whether one or more Foglight Agent Manager instances can (true) or cannot be upgraded (false). It can be set to a regular expression.