Foglight 5.9.3 - Installing Foglight on a UNIX System with an External MySQL Database

Setting memory parameters for the server

If you are running the Management Server by running bin/fms, you can configure the Java® Virtual Machine’s (JVM) minimum and maximum memory parameters for the server in the <foglight_home>/config/server.config file.

If you are starting Foglight using the run.[bat|sh] command, the JVM heap memory parameters set in the <foglight_home>/config/server.config file do not take effect. Use -X options to pass the memory parameters straight to the VM.

If your installation supports a large number (hundreds) of agents, you can set the Java® heap memory minimum (-Xms) and maximum (-Xmx) options to the same size. For example, assigning
1GB of memory can be set in the server.config file as follows:

Ensure that you uncomment these lines in the file.

You can set up to 100 VM options in total.

NOTE: The -Xms and -Xmx options are different for 32-bit and 64-bit JVMs and available physical memory. The values of the -Xms and -Xmx options do not necessarily have to be the same size. However, the value of the -Xmx option should not exceed certain limits that the System Administrator specifies.

Process heap use

When a thread is created and run, a run-time stack is dynamically allocated from the native process heap (not the Java® heap). This native heap requires a large contiguous memory block. If the system you are running does not have enough RAM, or if the operating system cannot find a large enough contiguous memory block, new native threads cannot be created and a java.lang.OutOfMemoryError occurs.

If the VM generates errors relating to a failure to allocate native resources, or relating to exhaustion of process address space, you must increase the native process heap size. Errors appear as a Java VM internal error message or a detail message associated with an out-of-memory error. Messages with the relevant errors indicate that the problem is process heap exhaustion.

You cannot directly set the size of the process heap. The process heap uses memory within the 32-bit address space not used by the garbage-collected heap. To increase the size of the process heap, decrease the maximum Java heap size using the -Xmx option in the server.config file.

The default stack size can be adjusted with the ‑Xss option.

Adding command-line options

The server.config file allows you to add up to 10 command-line options for the fms command.

Each command-line argument corresponds to a space-delimited argument passed to the Foglight process.

For example, the following lines in the <foglight_home>/config/server.config file:

Correspond to this direct argument on the command line:

Certain arguments can be specified in a single line that uses the long name for an option. For example:

Which corresponds to the following command-line argument:

Binding the Management Server to an IP address

To cause the Foglight Management Server to bind to a specific IP address, use the dedicated properties in the <foglight_home>/config/server.config file. For example:

server.bind.address = “192.0.2.2";

server.remote.address = “host1.example.com";

Where host1.example.com is the host name assigned to the bind address in DNS. If no DNS name is available, a raw IP address can be used in this property.

Binding Foglight to a specific IP address can be used where, for example, the same IP address is to be used by multiple Management Server instances on a single host, each IP address delineating a virtual boundary between instances. In such situations, the Management Server will only listen for incoming TCP traffic on that specific IP address. By default, the Management Server listens to all IPv4 and IPv6 addresses.