Chat now with support
Chat with Support

Foglight Evolve 9.0 - Command-Line Reference Guide

About the Command-Line Interface Managing the Foglight Management Server Managing the Foglight Agent Manager Managing Agents, Cartridges, and Metrics

Listing Agent and Agent Manager Instances

The clients command shows a list of Foglight Agent Manager instances.

fglcmd connection_options -cmd agent:clients [-regex] [-host host_name]
[-clientname display_name] [-clientid client_ID] [-clientbuild build_ID]
[-clientversion version] [-allclients] [-upgradable {true|false}]

allclients

None

Indicates that all instances of the Foglight Agent Manager should be listed.

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 the name of 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 .

host

host_name

An explicit text string or a regular expression that specifies the name of one or more hosts that are running an instance of the Foglight Agent Manager.

regex

None

Interprets the client_ID, diplay_name, host_name, or upgradable arguments as regular expressions.

For a sample regular expression used to specify a host name, see the 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.

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd agent:clients -host ".*.corp" -regex

For complete information about the regular expression syntax, see About Regular Expressions .

clients

The clients command shows a list of Foglight Agent Manager instances.

fglcmd connection_options -cmd agent:clients [-regex] [-host host_name]
[-clientname display_name] [-clientid client_ID] [-clientbuild build_ID]
[-clientversion version] [-allclients] [-upgradable {true|false}]

allclients

None

Indicates that all instances of the Foglight Agent Manager should be listed.

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 the name of 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 .

host

host_name

An explicit text string or a regular expression that specifies the name of one or more hosts that are running an instance of the Foglight Agent Manager.

regex

None

Interprets the client_ID, diplay_name, host_name, or upgradable arguments as regular expressions.

For a sample regular expression used to specify a host name, see the 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.

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd agent:clients -host ".*.corp" -regex

For complete information about the regular expression syntax, see About Regular Expressions .

list

The list command shows a list of Foglight agent instances.

fglcmd connection_options -cmd agent:list [-agentid agent_ID] [-regex]
[-adapter adapter_ID] [-host host_name] [-deletable {true|false}]
[-name agent_name] [-namespace agent_namespace]
[-datacollection {true|false}] [-all] [-type agent_type]
[-activatable {true|false}] [-active {true|false}]

activatable

true or false

Indicates whether to list agent instances that can (true) or cannot be activated (false).

active

true or false

Indicates whether to list agent instances that are active (true) or inactive (false).

adapter

adapter_ID

An explicit text string or a regular expression that identifies one or more Foglight adapters.

agentid

agent_ID

Identifies an instance of a Foglight agent that is to be listed.

all

None

Indicates that all agent instances should be listed.

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 .

datacollection

true or false

Indicates whether to list Foglight agent instances for which the data collection is (true) or is not enabled (false).

deletable

true or false

Indicates whether to list Foglight agent instances that can (true) or cannot be deleted (false).

host

host_name

An explicit text string or a regular expression that specifies the name of one or more hosts that are running an instance of a Foglight agent.

name

agent_name

An explicit text string or a regular expression that specifies the name of one or more Foglight agent instances that are to be listed.

namespace

agent_namespace

An explicit text string or a regular expression that specifies the name of one or more Foglight agent instances in the specified name space.

regex

None

Interprets the adapter_ID, agent_name, agent_namespace, agent_type, or host_name arguments as regular expressions.

For a sample regular expression used to specify a host name, see Example .

type

agent_type

An explicit text string or a regular expression that specifies one or more Foglight agent types.

The selection of available agent types depends on the collection of deployed cartridges. For example, a basic Foglight Management Server installation that includes the Cartridge for Infrastructure can two different agent types:

For more information about these agents, see the Managing the Infrastructure Cartridge User and Reference Guide.

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

packages

The packages command shows a list of available agent packages.

fglcmd connection_options -cmd agent:packages [-packageosversion OS_version]
[-regex] [-host host_name] [-clientname display_name]
[-packageversion version] [-arch architecture] [-packageid "pkg_ID"]
[-allclients] [-allpackages] [-allinstallers] [-osversion OS_version]
[-packagearch OS_architecture] [-clientid client_ID] [-clientbuild build_ID]
[-clientversion client_version] [-packageos OS_name] [-osname OS_name]
[-installername name] [-upgradable {true|false}] [-disable_platform_check]

allclients

None

Indicates that all instances of the Foglight Agent Manager should be selected.

allinstallers

None

Indicates that all agent installers should be selected.

allpackages

None

Indicates that all agent packages should be listed.

arch

architecture

An explicit text string or a regular expression that specifies the platform architecture.

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

client_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 .

disable_platform_check

None

Disables automatic filtering of agent packages, based on platform information provided by agent installers.

host

host_name

An explicit text string or a regular expression that specifies one or more host names.

installername

name

An explicit text string or a regular expression that selects one or more agent installers based on the specified name.

osname

OS_name

An explicit text string or a regular expression that specifies the name of one or more operating systems with which the agent packages are compatible.

osversion

OS_version

An explicit text string or a regular expression that specifies the version of one or more operating systems with which the agent packages are compatible.

packagearch

OS_architecture

An explicit text string or a regular expression that specifies one or more operating system architectures with which the agent packages are compatible.

packageid

pkg_ID

An explicit text string or a regular expression that identifies one or more packages.

packageos

pkg_OS_name

An explicit text string or a regular expression that specifies the name of one or more operating systems of the agent packages that are to be selected.

packageosversion

pkg_OS_version

An explicit text string or a regular expression that specifies one or more operating system versions of the agent packages that are to be selected.

packageversion

version

An explicit text string or a regular expression that specifies one or more package versions.

regex

None

Interprets the architecture, build_ID, client_ID, client_version, display_name, host_name, name, OS_architecture, OS_name, OS_version, pkg_ID, pkg_OS_name, pkg_OS_version, version, or upgradable arguments as regular expressions.

For a sample regular expression, 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.

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd agent:packages -allclients
Related Documents