Foglight for Databases Installation Requirements and Walk-Through

If you’d like to try out Foglight for Databases or Foglight for SQL Server, you can download the full software for a 30-day evaluation, and one of us here at Quest will be happy to assist you with getting it set up. The brief Installation Requirements section of this post will show you what you’ll need to have ready for our call.

But it’s an easy install, so you might just want to go ahead and try it yourself.  The Walk-Through section of this post covers that, step-by-step.

By the way, this post applies to the 5.7.5.x versions and is based on the Deployment Guide.  For later versions, please search the Technical Documentation section at the Quest Support Page.

 

Foglight does a lot, but the installation is pretty easy!

 

Installation Requirements

To be prepared for an install, you’ll need to:

  1. Download the installer here: Foglight for Databases.
  1. Have a service account that Foglight can use to connect to the servers you’d like to monitor. The easiest approach is to use a single domain admin account that has SQL and Windows Administrative permissions on the instances and hosts that you’d like to monitor.
  1. Have a physical or virtual machine to host Foglight, meeting the follow hardware requirements based on the total number of SQL Server + Windows connections you’d like to monitor:

Monitored Connections     <5     <50     <100     <200

CPU cores (2.4GHz)         4      12       16       18
RAM                       12 GB   26 GB    34 GB    46 GB
Drive Space               22 GB  205 GB    410 GB  820 GB
 
Important!: If hosting Foglight on a virtual machine, the RAM and CPU allocations must be reserved.

Run C:\Program Files\VMware\VMwareTools\VMwareToolBoxCmd.exe stat cpures from the command line in the VM itself to see whether CPU is currently reserved.  A result of "0Mhz" means that it isn't
Run C:\Program Files\VMware\VMwareTools\VMwareToolBoxCmd.exe stat memres to see if memory is reserved. A result of 0Mb means means that it isn't.
If you find that these resources have not been reserved, please have your VMware administrators do so.

 

 
4. Have a SQL or Oracle server where Foglight can create a repository database (with enough spaced allocated to cover 2Gb per monitored instance). This can be on the Foglight host, in which case the above specs will be fine, or you can point Foglight to an external database server, just make sure it's a back-office/tools server, not one of your production systems.

 

Walk-Through

On the machine where Foglight will be hosted, double click on the installation file (which should be named something like “foglight-5_7_5_5-foglightfordatabases_windows-x86_64” or “foglightforsql-server-5.7.5.35_windows-x86_64”.  This will bring up a simple intro screen:

 

Nothing to do here but have a quick read and hit Next.

 

You’ll have to accept the License Agreement to continue.

 

Choose Custom Install so you can see all of the options in the wizard.

 

Specify the drive location where Foglight should reside.

 

This screen is just an overly complicated way to say that we will be creating some Foglight shortcuts in the Start menu.  Just hit next, because if you want shortcuts on the desktop or in Quick Launch bar or wherever, you can just drag them there from the Start menu later, as you would with any program.

 

Go with the default setting of Enable Foglight as a Service.  That just means Foglight will automatically start up when you bounce the machine it’s on, instead of requiring you to manually start it.

 

This screen is just a review of the selections we’ve made.  If you’re happy with what you see, hit Install.

 

After the installation is complete, we’ve got a little setup to do.  This screen is just telling you that the administrator login to the Foglight console will default to a user name of “foglight” with a password of “foglight”.  You could specify something else here if you’d like, but you can also change it later at any time, so you can leave it as-is for now.

There’s also an option to use an HTTPS connection to Foglight.  This isn’t typically critical to do because most users connect to Foglight from within a secure network or across a VPN.

 

You have the option to create a second, standby Foglight server that can be failed over to in the event that your primary Foglight host experiences a failure.  This is rare requirement and can be set up later, so we’ll cover it in separate documentation.  So another Next here.

 

Foglight requires a database to store the data it collects.  The installer we’re running has the ability to create its own Embedded PostgreSQL database for this purpose, or you can create the database in PostgreSQL, SQL Server, Oracle or MySQL server that you already have in your environment.  Choosing SQL Server or Oracle will give you the best performance.

 

In this example, I’ve chosen SQL Server to host my Foglight repository, and I’ve got a SQL Server right on the same machine where I’m hosting Foglight itself, so I can go with localhost IP address of 127.0.01.  But you can of course point to an external server somewhere for Foglight to use, just remember that it should be a back-office/tools server, not one of your production systems.

You don’t need to change anything under Foglight Repository User Account, because this is simply the account that Foglight uses to write data to and read data from the repository database (called “foglight”).  The database isn’t really designed to be queried directly by users, but if you were so inclined you could create an account for yourself later for this purpose.

The last section on this screen (“Foglight Repository Administrator Account”) is the account uses to create the repository database.  We just use it once for this purpose, and the credentials you enter here don’t get saved off anywhere.

 

This box shows the ports that Foglight uses.  Only two of the ports (8080 and 8443) are involved in any traffic inbound to or outbound from the Foglight host – they are simply the HTTP and HTTPS ports that you connect to Foglight over when you bring up its browser-based interface.  All the rest of the ports are only used locally on the Foglight host for the various components of Foglight to talk amongst themselves.  So really, just a Next here.

 

If the machine hosting Foglight is not running any other major software packages, you can choose the default of allowing Foglight to manage its memory consumption.  If the host is not dedicated to Foglight, then choose the size of the environment that you will be monitoring so that Foglight better shares resources with the other applications you are running on its host.

 

The default trial license option will give you 30 days to try out all of Foglight’s features, on as many systems as you’d like to monitor.  If you’ve been sent a license file you can browse to it here, but that can also be done later from within the Foglight console.

 

This screen just gives some review of what we’ve set up.  Review end click Done.

 

The Foglight console might automatically pop up, but if it doesn’t just navigate to in in a browser at http://localhost:8080 or https://localhost:8080 if you’re on the Foglight host, or replace “localhost” with the name of the Foglight host server if you’re connecting from another location.

 

Now we’re at the start page, and the next step will be to point Foglight to the SQL Instances and Windows hosts that we’d like to monitor.  That is covered in another post which can be found here.

 

A couple of manual changes

For optimal performance of Foglight, please manually make the following changes:

In the table below, find the JVM Settings size necessary for your desired number of monitored connections, and then use it to edit the files mentioned below as follows:

Monitored Connections     <5        <50        <100        <200
JVM Settings               5.1 GB    10.2 GB     12.3 GB     18.4 GB
  
Edit the <Foglight installation directory>\config\server.config file.
For 5.1 GB (for example), ADD the following lines:
server.vm.option0 = "-Xms5100m"; server.vm.option1 = "-Xmx5100m";
 
Edit <Foglight installation directory>\fglam\state\default\config\baseline.jvmargs.config file
For 5.1 GB (for example), ADD the following lines:
vmparameter.0 = "-Xms5100m"; vmparameter.1 = "-Xmx5100m";
 

If you will be monitoring more that 50 SQL Server + Windows systems:

ALTER the following lines in <Foglight installation directory>\fglam\state\default\config\fglam.config.xml to the below values:
 
config:upstream attribute max-disk-space="102400"
config:downstream attribute max-disk-space="102400"
vmparameter.2 = “Dcom.quest.connection.regulator.maxActiveConnectionsCap=1024”;
 
When you're done making these changes, restart the Foglight service.
All of my Quest Database Performance blog posts can be found here.
Anonymous