Below are general instructions for Foglight agents. Please refer to KB 124120 for details on creating database agents using the Command Line Installer.
create
The create command produces one or more Foglight agent instances.
You can create an agent instance after deploying the agent package on the Foglight Management Server. To create an agent instance that collects data, you first create the agent instance, activate it, and then start the data collection for that agent instance. Similarly, when you want to remove an agent instance, use a reverse order of actions: first stop the agent instance, deactivate it, and then delete it.
Syntax
fglcmd connection_options -cmd agent:create -nameagent_name -typeagent_type {-clientname display_name|-clientid client_ID|-clientbuild build_ID| -clientversion version| -allclients} [-hosthost_name] [-force] [-regex] [-upgradable {true|false}]
Options and arguments (option in bold; arguement in underline)
- allclients NoneIndicates 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 display devices that are running an instance of the Foglight Agent Manager.
- clientname display_name An explicit text string or a regular expression that specifies one or more monitored hosts on which the Foglight Agent Manager is running.
- 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.
- force None In cases where multiple agents are selected, it indicates that all selected agents should be created.
- host host_name An explicit text string or a regular expression that specifies one or more host names.
- name agent_name An explicit text string or a regular expression that specifies one or more agent names.
- regex None Interprets the build_ID., client_ID, display_name, host_name, version, or upgradable arguments as regular expressions.
- 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:
• WindowsAgent
• UnixAgent
Note For more information about these agents, see the Managing the Infrastructure Cartridge User and Reference Guide. - 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
Using a regular expression to select hosts
C:\Quest_Software\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd agent:create -type Windows_System -host .*.corp -name MyAgentX -regex -force
Note If successful, this command does not generate any output.
Using a literal value to select a Foglight Agent Manager instance
C:\Quest_Software\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd agent:create -type WindowsAgent -name Agent5 -clientname Host1
Note If successful, this command does not generate any output.