Chat now with support
Chat with Support

Foglight for Java EE Technologies 5.9.12 - Installation Guide

Installing and Configuring Foglight for Java EE Technologies Integrating with JBoss Integrating with Apache Tomcat Integrating with WebLogic Domain Startup Scripts Integrating with WebSphere Integrating with WebSphere Liberty Integrating with Oracle AS Integrating with Spring Boot for Embedded Tomcat Creating a Generic Installation for Manual Java EE Agent Integration Managing Java EE Agent Installations, Integrations, and Configurations Managing Java EE Agent Configurations Managing Java EE Installation Java EE Integration Configuration FAQ and Troubleshooting Manually Integrating Application Server Appendix A: Java EE Application Methods AppendixB: Managing Permissions for the Java EE Integration Agent

Reintegrating existing targets

To keep your application servers up to date, you can edit the properties of an integration task, and then reintegrate either a single target, or all targets using that particular configuration.

To reintegrate a target:
1
On the navigation panel, under Dashboards, click Application Servers > Administration.
2
On the Application Servers Administration dashboard, click the Java tab.
3
On the Java view, click the Integration Configurations tab.
4
In the list of Configuration Name and Targets, click the name of the integration configuration task. For example: Generic installation only on Windows: Install Configs and Preinstrument.
5
In the list that opens, click Properties.
6
In the Integration Task Properties dialog box, update the Java Home or Preinstrumentor Options as necessary.
7
Click Save.
8
In the Integration dialog box, click OK if you want to reintegrate all targets that use the configuration.
Or
Clear the check box if you want to reintegrate only certain targets, then click OK.
9
Optional — In the list of Configuration Name and Targets, do one of the following:
•
To reintegrate a single target, expand the configuration group by clicking the ‘+’ sign, then click the name of the target you want to reintegrate (for example, appserver.example1.com: WebLogic on Windows: startWebLogic). In the menu that opens, click Reintegrate.
•
To reintegrate all targets that are using the same integration configuration, click the configuration name (for example, WebLogic on Windows: startWebLogic). In the menu that opens, click Reintegrate targets.

Deleting and undoing an integration

There are two options for removing integrations from targets:

•
Delete only — use to remove integrations on decommissioned hosts or to delete stale integrations that have been superseded. Deletion permanently removes all records of the integration target.
•
Delete and undo integration — use to restore the target host to its pre-integration state. This option is useful when the integration is still active on the target.
To delete an integration:
1
On the navigation panel, under Dashboards, click Application Servers > Administration.
2
On the Application Servers Administration dashboard, click the Java tab.
3
On the Java view, click the Integration Configurations tab.
4
In the list of Configuration Name and Targets, expand the configuration group by clicking the ‘+’ sign, then click the name of the target you want to delete.
5
In the list that opens, select either Delete only, or Delete and undo integration, as necessary.

Reusing an integration configuration

The first time you install a Java EE agent, create an integration configuration that is specific to the type of application server you are integrating with. During the process of creating the integration, you can choose to save it as a reusable task. Reusing a saved integration configuration allows you to quickly set up multiple agents with the same configuration.

To reuse an integration configuration:
1
On the navigation panel, under Dashboards, click Application Servers > Administration.
2
On the Application Servers Administration dashboard, in the Monitoring Agents section, click Setup agents...
3
In the menu that opens, select Java. The wizard opens.
4
On the Setup Options page of the wizard, click Reuse previous application server integration details.
Click Next.
5
On the Integration Configuration page, select a saved integration task from the list.
Click Next.
6
On the Nexus Connection page, select or create the connection that the agent should use to connect to the Nexus.
* 
TIP: For more information about the Nexus, see Nexus and Agent-Nexus connections .
Select a Nexus connection from the list and click Next.
7
On the Logging page, select or create a logging configuration to control how logs are written, including retention policies and rollovers.
•
Select an existing log configuration from the list. The default log provides a basic log configuration that you can use to get started quickly.
•
Click New log configuration. The New Log Configuration dialog box opens.
* 
TIP: If you are uncertain about how to adjust these settings, click Help for an overview of log targets and their purposes. For more information, see Creating or editing logging properties.
Click Next.
8
On the Integration Hosts page, select the host that you want to integrate with. By default, only eligible hosts (that is, hosts that have an active Foglight Agent Manager of a compatible version installed and running) are listed.
Select the host and click Next.
9
On the Agent Configuration page, select the configuration that you want the agent to use. The configuration controls request monitoring and collection details information.
* 
TIP: For more information, see Managing Java EE Agent Configurations.
Select the configuration and click Next.
10
On the Installation Directory page, define the location for the directory that contains all installation components and log files. To accept the default directory, leave the Installation Directory box blank.
* 
IMPORTANT: If you have previously configured the host for agent installation, the existing installation directory is used.
To specify a custom directory, type a path in the Directory name box.
Click Next.
11
On the Review page, verify the details of the integration.
Click Finish.
The Application Servers Administration dashboard refreshes, and the integration task appears in the Task History list, where you can monitor its progress.
12
Restart your application server.

The agent starts collecting data after the application server has restarted and the agent is successfully integrated.

Use the Application Servers Monitor dashboard to view the application servers status. For more information about the Application Servers Monitor dashboard, see the Foglight for Application Servers User Guide.

Managing Java EE Agent Configurations

The agent configuration controls what data the agent collects. These settings are stored in a file called instrumentation.config. You can edit the instrumentation settings through a GUI editor that is available on the Agent Configurations tab of the Java Administration dashboard.

To manage agent configurations:
1
On the navigation panel, under Dashboards, click Application Servers > Administration.
2
On the Application Servers Administration dashboard, click the Java tab.
3
On the Java view, click the Agent Configurations tab.
From here, you can create an agent configuration or edit an existing one (instrumentation.config), or edit version-specific agent configuration files.

For more information, see:

•
Creating agent instrumentation configurations
•
Editing agent instrumentation configurations
•
Managing other Java EE agent configuration files
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating