Chat now with support
Chat with Support

Foglight for Java EE Technologies 5.9.9 - Installation Guide

Install and Configure Foglight for Java EE Technologies Integrate with JBoss Integrate with Apache Tomcat Integrate with WebLogic Domain Startup Scripts Integrate with WebSphere Integrate with Oracle AS Create a Generic Installation for Manual Java EE Agent Integration Manage Java EE Agent Installations, Integrations, and Configurations Managing Java EE Agent Configurations Java EE Installation Management Java EE Integration Configuration FAQ and Troubleshooting Manual Application Server Integrations AppendixB: Managing Permissions for the Java EE Integration Agent Appendix A: Java EE Application Methods

Integrate with JBoss

You can use the application server agent setup wizard to configure and integrate the Java EE agent and the Java EE Integration Agent with JBoss® server startup scripts. You must supply the JBoss Home directory for one or more application servers with which you want to integrate. Optionally, you can also specify pre-instrumentation and agent options.
 
* 
IMPORTANT: Foglight for Java EE Technologies version 5.9.x is the last major release that supports JBoss AS (all versions), and JBoss EAP 4.3. Support for these versions of JBoss will be discontinued after this release.
For an overview of the installation and integration process, see Install the agents .
To integrate with JBoss on UNIX® or Windows®:
 
* 
IMPORTANT: Ensure that the target application server has an active Foglight Agent Manager of a compatible version installed and running.
1
On the navigation panel, under Dashboards, click Application Servers > Administration > 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 Java — Setup New Application Server Integration wizard opens.
4
On the Setup Options page, select the type of integration. This example describes how to Setup a new application server integration (the default selection).
* 
TIP: For other integration methods, Reusing an integration configuration .
5
On the New Integration — Type page, select the type of Java application server you want to integrate with. In this case, select either JBoss on Solaris, Linux, HP-UX, or AIX, or JBoss on Windows, as appropriate.
a
The wizard refreshes, indicating that it will use the JBoss Startup Scripts. This option integrates the JBoss run.bat or run.sh startup scripts.
b
Click Next.
6
On the New Integration — Details page, specify any additional information required to integrate with the application server.
a
Type or select the absolute path to the JBoss Home directory. This is the JBoss installation location on the remote file system.
b
Optional — If your application server uses startup scripts with customized names, click the arrow beside Other Options to open a list of script paths and names. Type the custom names in the appropriate boxes.
 
* 
NOTE: Always use forward slashes to separate directory names, regardless of whether the application server is running on Windows or UNIX.
c
Optional — Click the arrow beside Command Line Options to show the agent and pre-instrumentor option boxes. Use these boxes to provide command-line parameters for the agent or pre-instrumentor.
•
To add agent options, type them in the Agent Options box.
For example, if the JBoss .jar files are located in a lib/endorsed directory, add the following option in the Agent Options box:
‑Dquest.agent.instrument.bootstrap=true
 
* 
NOTE: If you need to add more than one option to the Agent Options, separate them with spaces. Do not use quotes.
•
To add pre-instrumentation options, type them in the pre-instrumentor Options box.
To set pre-instrumentor options specific to the JVM you are running, type the desired VM options in the pre-instrumentor Options box.
For example, to set the memory limit for the pre-instrumentor to 256MB, type the following: ‑Xmx256m
 
* 
NOTE: If you need to add more than one option to the pre-instrumentor Options, separate them with spaces. Do not use quotes.
 
* 
TIP: For information about pre-instrumentation, see Configuring Java Homes pre-instrumentation .
d
Click Next.
7
On the Nexus Connection page, select or create the connection that the agent should use to locate and communicate with a Nexus.
 
* 
TIP: For more information about the Nexus, see The Nexus and Agent-Nexus connections .
If you are using the default Nexus on the embedded Agent Manager, or if you have created a single remote Nexus, a default Nexus Connection is created and pre-selected for you.
Otherwise, select or define at least one Nexus connection. For more information, see Creating or editing Agent-Nexus connection settings.
Click Next.
8
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 provides a basic log configuration that you can use to get started.
Or
•
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 details, see Creating or editing logging properties .
Click Next.
9
On the Integration Hosts page, select the monitored host where the JBoss application server is installed. 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.
10
On the Agent Configuration page, select the configuration for the agent to use. This agent configuration defines the requests to monitor and collect details.
 
* 
TIP: You can create agent configurations or edit existing ones from the Java Administration dashboard. For more information, see Managing Java EE Agent Configurations.
Select a configuration and click Next.
11
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 Directory name box empty.
 
* 
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.
12
On the Review page, verify the details of the integration.
a
By default, the instrumentation script is assigned a name based on the integration type. For example: JBoss on Windows: ServerRunScript. If you want to customize this name, type the new value in the Name box.
b
Click Finish.
The Application Servers Administration dashboard refreshes, and the integration task appears in the Task History list, where you can monitor its progress.
13
Restart your application server.
The agent starts collecting data after the application server has restarted and the agent is successfully integrated.
Next steps:
•
If you are running JBoss with Jetty, see Running JBoss with Jetty .
•
If you want to collect JTA metrics for JBoss AS 4.2, see Enabling JTA metrics for JBoss application server 4.2 .
•
If you are integrating with the Java Service Wrapper, see Integrating a Java Service Wrapper Windows Service with a Java EE agent .
•
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.
•
If for any reason you need to manully integrate a JBoss agent, see JBoss remote agent integration from the command-line .

Enabling JTA metrics for JBoss application server 4.2

By default, statistics are not enabled for the Transaction Manager Service in JBoss® version 4.2.
 
* 
NOTE: Foglight for Java EE Technologies version 5.9.x is the last major release that supports JBoss AS. Support for JBoss AS will be discontinued after this release.
To allow the Java EE agent to collect JTA statistics:
1
Locate the jbossjta-properties.xml file in your JBoss server/<profile>/conf directory and open it in a text editor.
2
Add the following line to the <properties> element.
<property name="com.arjuna.ats.arjuna.coordinator.enableStatistics" value="YES"/>
3
Restart your JBoss application server.
Related topics:
•
Integrate with JBoss

Running JBoss with Jetty

Jetty is a pure Java-based HTTP server and servlet container (application server). If you are running JBoss® with Jetty, make the following changes to the property file agent_type_jboss-<version>.config before you start recording.
 
* 
IMPORTANT: Foglight for Java EE Technologies version 5.9.x is the last major release that supports JBoss AS (all versions) and JBoss EAP 4.3. Support for these versions of JBoss will be discontinued after this release.
The following table lists the <version> names:
 
Table 1. Application Server version names.
Application Server
Version
Application Server 4.2.[0-3]
agent/java/plugins/jboss-420.config
Application Server 5.0.[0-1] or 5.1.0
agent/java/plugins/jboss-5.config
Application Server 6.0.0 or 6.1.0
agent/java/plugins/jboss-6.config
Application Server 7.0.[0-2]
agent/java/plugins/jboss-7.config
EAP 6
agent/java/plugins/jboss-eap-6.config
To edit the agent .config file:
1
On the navigation panel, under Dashboards, click Application Servers > Administration > Application Servers Administration.
2
On the Application Servers Administration dashboard, click Java Administration.
3
On the Java Administration page, click the Agent Configurations tab.
4
In the Agent Configuration view, click Advanced Configurations.
The Advanced Configuration view opens.
5
Select the version of the Java EE agent that you want to edit. Click Version x.x.x to open a list of compatible versions.
6
Click the name of the agent/java/plugins/jboss-<version>.config for the JBoss version you want to edit, and select Edit.
 
* 
TIP: Click Show fully qualified names to see the directory location for the files. Type all or part of the filename in the Search box (for example, jboss-) to locate the file.
7
In the text editor, scroll down to locate and comment out the following line:
"com.quest.pas.agent.plugin.instrumentor.method.ServletInstrumentor",
8
Uncomment the following lines:
#"com.quest.pas.agent.plugin.instrumentor.method.HttpServletInstrumentor",
#"com.quest.pas.agent.plugin.instrumentor.ServletRequestInstrumentor",
9
Click Save.
10
Restart your application server.
Related topics:
•
Integrate with JBoss

Integrating a Java Service Wrapper Windows Service with a Java EE agent

Foglight for Java EE Technologies supports the use of Windows Services configured using the Java Service Wrapper (JSW) application by Tanuki Software.
The JSW uses configuration files to control how your Java application is started and stopped as a Windows Service. To integrate the Java EE agent with your JSW, the JDK must be pre-instrumented (using the Java EE Integration Agent) and then the JSW configuration file needs to be manually modified to include Java EE agent configuration settings.
To integrate the Java Server Wrapper with a Java EE agent:
1
Create an installation, as described in Create a Generic Installation for Manual Java EE Agent Integration .
2
After the generic installation is complete, a new file appears in the following directory on the machine where you ran the pre-instrumentation.
Windows®: <VERSIONED_SUBDIRECTORY>\bootstrap\<INTEGRATIONID>
UNIX®: <VERSIONED_SUBDIRECTORY>/bootstrap/<INTEGRATIONID>
You can find the <INTEGRATIONID> in the file that the Java EE Integration Agent creates in step 1.
3
Run the integration bat/sh file that was created by the manual installation.
4
Open the JSW configuration file in a text editor, and add the following code before the first wrapper.java.additional code:
#include <INSTALLATION DIRECTORY>\jee_builds.properties
#set.JAVA_HOME=<JVMPath>
set.QUEST_INTEGRATIONID=<INTEGRATIONID>
set.PERFORMASURE_BOOTSTRAP=-Xbootclasspath/p:%QUEST_AGENT_HOME%\bootstrap\%QUEST_INTEGRATIONID%\<BOOTSTRAP.JAR FILENAME>
set.PERFORMASURE_JAVAAGENT=-javaagent:%QUEST_AGENT_HOME%\lib\performasure-agent.jar
a
Replace <INSTALLATION DIRECTORY> with the absolute path of the Installation Directory. The path can be found on the Installations tab of the Java Administration page (accessible from the Applications Servers Administration dashboard). If the Installation Directory path is specified as a relative path, as it is by default, you may need to examine the agent machine to determine the absolute path.
b
If set.JAVA_HOME is not specified earlier in the JSW configuration file, uncomment the second line in the code block above and set <JVMPath> to the absolute path for the JVM that the service uses.
For example: set.JAVA_HOME=C:\work\jvms\jdk1.5.0_12
Or, if the path is set in a different variable, such as JRE_HOME:
set.JAVA_HOME=%JRE_HOME%
c
Replace <INTEGRATIONID> with the value determined in step 2.
d
Replace <BOOTSTRAP .JAR FILENAME> with the filename of the bootstrap JAR file created in the <VERSIONED_SUBDIRECTORY>/bootstrap/<INTEGRATIONID> directory by the pre-instrumentation task in step 1.
5
In the JSW configuration file, add the following code after the last existing wrapper.java.additional entry:
wrapper.java.additional.<N>=%QUEST_INTEGRATIONID%
wrapper.java.additional.<N>=%PERFORMASURE_JAVAAGENT%
wrapper.java.additional.<N>=%PERFORMASURE_BOOTSTRAP%
and replace <N> with incremented numbers starting after your highest wrapper.java.additional number.
6
Save your JSW configuration file and then restart your JSW service.
Related topics:
•
Integrate with JBoss
 
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating