Foglight 6.1.0 - Installing Foglight on Windows with an External MySQL Database

Migrating data from an existing database

The contents of the MySQL® database can be copied to another MySQL instance via an export/import cycle.

The following procedure performs a full export of the database and can be run against a database currently in use by a server.

NOTE: The Foglight servers must be stopped during the import process.

When moving a database between environments, care should be taken to ensure that the Foglight schema version is lower or equal to the Management Server version in the destination environment, as an upgrade to a new schema is possible. Start the Management Server with the option:

-Dfoglight.database.upgrade=true

or run foglight_db_upgrade.bat.

Running the Management Server FAQ

On Windows®, Foglight starts the Quest Common Process Runner (qcn_runner.exe) but does not use it to launch new processes.

It is recommended that you do not use this method to stop the Management Server. However, if you do use this method, follow the following workaround.

The Foglight browser interface requires JavaScript. You may need to modify the security settings in your web browser to enable this functionality. Depending on your browser, this setting may be labeled either “Enable JavaScript” (for example, in Firefox®), or “Enable Active Scripting” (for example, in Internet Explorer®).

The default link to the login page points to http://localhost:8080. In some instances, this link may not correspond to the URL of your Foglight server, resulting in the link not working. This issue can also occur when Foglight is not able to identify your local host. Add your host/IP information to the etc/hosts files to correct this issue.

Configuring the Management Server with a link-local IPv6 address is not supported because many web browsers do not support link-local IPv6 addresses. To correct this issue, update your host/IP information in the etc/hosts file.

Installing and Upgrading Cartridges

Using the Foglight Administration Module, you can install cartridges on the machine hosting the Management Server, enable and manage cartridges, and download agent installers.

The Cartridge Inventory dashboard contains controls for installing, enabling, disabling, and uninstalling cartridges, and for viewing information about the installed cartridges.

Installation is the first step in adding a cartridge to the Management Server. A cartridge file has the extension .car. Installing the .car file causes the Management Server to be aware of all cartridges in the .car file.

A cartridge must also be enabled before it is added to the Management Server. You can choose to enable a cartridge during installation, or afterward. See the Administration and Configuration Help for instructions on enabling and disabling cartridges after installation.

If the installation is successful, the message “Cartridge has been installed successfully” appears in the Install Cartridge area and the cartridge is listed in the Cartridge Inventory.

If Enable on install was not selected (see Step 4), a disabled symbol () appears in the row for that cartridge in the Installed Cartridges table on the Cartridge Inventory dashboard.

For more information about cartridge installation and configuration, see the Administration and Configuration Guide.

NOTE: Warning messages similar to the following appear in the Management Server log when you install a cartridge: WARN — Module system:<name> was converted to the newest version during loading These warnings are expected and do not affect functionality.

To obtain a full list of the cartridges installed on the Management Server, open the Cartridge Inventory dashboard (Administration > Cartridges > Cartridge Inventory), and select Cartridge Inventory Report from the Reports menu.

For complete cartridge upgrade instructions, see the Upgrade Guide.

Installing Agents

A cartridge may include one or more executable Foglight agent installers. The agent installers included in a cartridge are listed on the Components for Download dashboard (on the navigation panel, select Administration > Cartridges > Components for Download).

Agents must be installed on all the machines you want to monitor. For agents that are installed on the monitored host, you must install and configure the Agent Manager.

NOTE: Foglight 4-converted agents create two processes for themselves when activated by the Agent Manager.

For more details, see these topics: