Foglight 5.9.1 - Installing Foglight on Windows with an External PostgreSQL Database

Next steps

To install cartridges, see Installing and Upgrading Cartridges.

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.

If Management Servers that are not part of a particular HA partition are configured to multicast using the same port on the same subnet as the Management Servers within the HA partition, errors like the following appear in the logs for the Management Servers that are configured in this way:

ERROR [UDP mcast receiver] org.jgroups.protocols.UDP - message does not have a UDP header

or

ERROR [UDP mcast receiver] org.jgroups.protocols.UDP - discarded message from different group

If you see this type of message, change the cluster multi-cast port of the servers that are reporting the error. In addition, if you plan to have multiple High Availability (HA) partitions on the same sub-net, configure a different cluster multicast port for each HA partition. See Configuring the cluster multicast port used in High Availability mode for instructions.

IMPORTANT: In both cases described here (resolving errors and planning to have multiple HA partitions on the same subnet), the primary server and secondary servers within each HA partition must be configured to use the same cluster multicast port.

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.