Foglight for Java EE Technologies 5.9.9


	IMPORTANT: To install or upgrade Foglight for Java EE Technologies, you must belong to a user group that has Foglight Security role permissions. For more information about assigning user permissions, see the Foglight Administration and Configuration Guide.

Adjusting the Agent Manager settings for the Nexus

If you intend to use the default Nexus running in the embedded Foglight for Java EE Technologies Agent Manager, you must adjust the Agent Manager disk cache settings before installing and configuring Foglight for Java EE Technologies. The default Nexus is created as part of the installation process.

The Agent Manager accumulates messages that are destined to be sent either upstream or downstream in queues between connections. This prevents messages from getting lost in the event of a disconnection.

Increase the Agent Manager disk cache size to ensure that data submissions from the Java agent are not discarded. See the documentation in the fglam.config.xml file for detailed descriptions of the options.


	NOTE: This procedure is recommended for all installations.

To adjust the Agent Manager settings for use with the Nexus:

Navigate to your Agent Manager config folder. For example: C:\Quest_Software\Foglight_Agent_Manager\state\default\config.

Open the vm.config file in an editor.


	IMPORTANT: In Agent Managers version 5.6.10 and later, this file is named baseline.jvmargs.config.

Uncomment and set the following setting to:

vmparameter.0 = “-Xmx1024m”;

Save and close the .config file.

In the same config directory, open the fglam.config.xml file in an editor.

Edit the config:queue-sizes and max-disk-space settings as follows:

<config:queue-sizes>
    <config:upstream max-queue-size="500" max-disk-space="100000" max-batch-size="500" allow-runtime-change="false"/>
    <config:upstream-verified max-queue-size="250" max-disk-space="50000" max-batch-size="250" allow-runtime-change="false"/>
    <config:downstream max-queue-size="500" max-disk-space="1024" max-batch-size="500" allow-runtime-change="false"/>
</config:queue-sizes>

This sets the max-disk-cache size to 100MB for the upstream and upstream-verified queues (normal and verified submissions).

Save and close the fglam.config.xml file.

Restart the Agent Manager.

If the Nexus is running in a non-embedded Agent Manager, the Agent Manager service must be restarted.

If the Nexus is running in the embedded Agent Manager (for example, if you are using the default Nexus), do one of the following:

•

Restart the Management Server.

•

Go to <server>/jmx-console (for example, http://yourhost:8080/jmx-console/) and click: service=EmbeddedFglAm.

Invoke the Stop() operation, and then invoke the start() operation.

If you still find warnings in the Agent Manager log about the disk cache being too small, increase the max-disk-space values for the upstream and upstream-verified queues.

Next step:

•

After you have adjusted the settings and restarted the Agent Manager, continue with Install and Configure Foglight for Java EE Technologies.

Installing Foglight for Java EE Technologies

Foglight for Java EE Technologies is distributed in a .car file, ApplicationServers-Java-<version>.car. Installing the cartridge file on the Management Server adds the capabilities for monitoring Java EE systems to your Foglight for Java EE Technologies environment.

Prerequsites:

•

Ensure that you have the correct environment as outlined in the Foglight for Java EE Technologies Release Notes and the Supported Platforms and Servers Guide.

•

Adjusting the Agent Manager settings for the Nexus.

•

You must belong to a user group that has Foglight Security role permissions. For more information about assigning user permissions, see the Foglight Administration and Configuration Guide.

The installation process is common to all Foglight cartridges. For instructions for installing and enabling the cartridge, see Install Foglight cartridges in the Foglight Administration and Configuration Help.


	NOTE: The cartridge file installation requires approximately 50MB of additional hard drive disk space on the Foglight Management Server.

To view the Cartridge for Java EE Technologies:

•

On the navigation panel, under Dashboards, click Administration > Cartridges > Cartridge Inventory. Search for “Java”.

Nexus services

Foglight for Java EE Technologies includes technology for distributed Java EE performance and monitoring data collection called the Nexus. The Nexus runs as a service hosted on a Foglight for Java EE Technologies Agent Manager. This service is part of the cartridge; disabling the cartridge stops Nexus services and enabling the cartridge starts them.

For information about configuring the Nexus, see The Nexus and Agent-Nexus connections .

Install the agents

Foglight for Java EE Technologies includes the Application Servers Administration dashboard. Use this dashboard to install agents and integrate them with application servers.


	NOTE: Agents should be installed using an account that has administrator privileges. For more information, see Java EE Integration Agent user permissions .

Installation and integration process

Set up the integration host (the application server with which you want to integrate):

•

Deploy a Foglight Agent Manager of the correct version to each host that you want to monitor with a Java EE Agent. Use the Deploy Agent Package option on the Administration > Agents > Agent Hosts dashboard.


	TIP: If you are uncertain of the required Agent Manager version, see the Foglight for Java EE Technologies Supported Platforms and Servers Guide, or the Foglight for Java EE Technologies Release Notes.

Make sure that you have a Nexus available, and check that the Nexus agent is up and running.

The Nexus receives and correlates data from the Java agent. For more information about the Nexus, and for tasks relating to Nexus creation and management, see the Foglight for Application Servers Administration and Configuration Guide or online help.

Use the Java — Setup New Application Server Integration wizard to configure an integration. This wizard is available through the Application Servers > Administration > Application Servers Administration dashboard.

Use the wizard for the following activities:

•

Create the Integration Agent that manages the Java (monitoring) agent and your application server integration.

•

Set the required information for the connection with the Nexus.

•

Set logging, agent configuration (data recording settings), and installation directory details.

For detailed instructions on using the wizard, see Installing a Java EE agent and the appropriate topics for the application server type you are attempting to integrate. You may also want to review the information in Java EE Integration Agent user permissions before using the wizard.