Foglight Evolve 9.3 - Command-Line Reference Guide

Installing or Uninstalling Cartridges

The install command installs a cartridge on the Foglight Management Server.

fglcmd connection_options -cmd cartridge:install [-passive] [-f file_path]

Table 22. Options and arguments
Option	Argument	Description
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 .
passive	None	Indicates that the cartridge should be installed, but not activated.
f	file_path	Specifies the path and file name of the cartridge file that is to be installed.

Example

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd cartridge:install -f C:\Quest\carts\Infrastructure-5_8_0.car

Cartridges installed:

----

Name: Infrastructure version: 5.9.x (enabled)

Name: HostAgents version: 5.9.x (enabled)

•

•

•

•

install

Installing or Uninstalling Cartridges

The install command installs a cartridge on the Foglight Management Server.

Scope

cartridge

Syntax

fglcmd connection_options -cmd cartridge:install [-passive] [-f file_path]

Table 22. Options and arguments
Option	Argument	Description
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 .
passive	None	Indicates that the cartridge should be installed, but not activated.
f	file_path	Specifies the path and file name of the cartridge file that is to be installed.

Example

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd cartridge:install -f C:\Quest\carts\Infrastructure-5_8_0.car

Cartridges installed:

----

Name: Infrastructure version: 5.9.x (enabled)

Name: HostAgents version: 5.9.x (enabled)

•

•

•

•

uninstall

The uninstall command uninstalls a Foglight cartridge.

You can only uninstall a disabled cartridge. For information on how to disable a cartridge using the fglcmd interface, see disable .

Scope

cartridge

Syntax

fglcmd connection_options -cmd cartridge:uninstall [-n name] [-v version]

Table 23. Options and arguments
Option	Argument	Description
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 .
n	name	Specifies the name of the cartridge that is to be uninstalled.
v	version	Specifies the version of the cartridge that is to be uninstalled.

Example

C:\Quest\Foglight\bin>fglcmd -usr foglight -pwd foglight -cmd cartridge:uninstall -n Infrastructure -v 5.9.x


	NOTE: If successful, this command does not generate any output.

•

•

•

•

Enabling or Disabling Cartridges

disable

The disable command deactivates a Foglight cartridge.

When you install a cartridge on the Foglight Management Server using default options either through the fglcmd interface or the Administration dashboards, Foglight activates that cartridge upon creation. For information on how to install a cartridge using the fglcmd interface, see install ; to find out how to activate an inactive cartridge using fglcmd, see enable .

Scope

cartridge

Syntax

fglcmd connection_options -cmd cartridge:disable [-n name] [-v version]

Table 24. Options and arguments
Option	Argument	Description
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 .
n	name	Specifies the name of the cartridge that is to be disabled.
v	version	Specifies the version of the cartridge that is to be disabled.