Foglight for Java EE Technologies 5.9.9

Set the environment variable QUEST_PREINST_OPTS with the desired VM options. The environment variable QUEST_PREINST_OPTS is passed to the Java EE Agent pre-instrumentor script.

For example, to set the memory limit for the preinstrumentor to 256MB, specify the following: QUEST_PREINST_OPTS="-Xms256m"

Integrating on a UNIX operating system

To integrate the Java EE agent with Tomcat on UNIX:

Make a copy of your original catalina.sh script.

By default, you can find this script in the <tomcat_home>/bin/ directory.

Complete a Generic installation only on Windows, as described in Create a Generic Installation for Manual Java EE Agent Integration .

Open the catalina.sh script in a text editor and change the following:

Immediately before the line:

if [ "$1" = "debug" ] ; then

Insert the following block of code:

# QUEST_PREINST_OPTS=* OPTIONAL pre-instrumentor Options *
# export QUEST_PREINST_OPTS
QUEST_DEPLOYMENT_DIRECTORY=* SET JavaEE Installation Directory *
if [ "$1" != "stop" ]; then
if [ -f "$QUEST_DEPLOYMENT_DIRECTORY/<integrate.sh>" ]; then
QUEST_JAVA_ENV_OPTS=TOMCAT
. "$QUEST_DEPLOYMENT_DIRECTORY/<integrate.sh>"
else
echo Java EE agent not enabled
fi
fi

Set <integrate.sh> to the name of the integration task you created in step 2. For example: integrate-Generic_installation_only_on_UNIX_Install_Configs_and_pre-instrument.cmd.

Set the QUEST_DEPLOYMENT_DIRECTORY variable to the Deployment Directory specified by the Java EE Integration Agent instance that is activated on this host.


	IMPORTANT: Enclose this path in double quotes if it contains spaces.

Save the startup script.

If it is not already running, start the Foglight Management Server. The instrumented Tomcat Server attempts to connect to the Foglight Management Server when the Tomcat Server is started using the modified script.

Use the modified script to start Tomcat.

The Foglight console confirms that a Tomcat Agent has connected by displaying a message similar to:

INFO Accepted connection from Tomcat Agent on <hostname>

In addition, the log file for the Tomcat Agent contains an INFO message stating that it has connected to the Foglight Management Server.


	IMPORTANT: By default, Agent log files are created in the logs subdirectory of the Foglight home directory on the Agent machine.

Integrating with Tomcat on Windows

Follow these instructions to integrate Tomcat with Foglight for Java EE Technologies by modifying your Tomcat startup script.

Review the following exception before you configure your server. If this exception applies to your environment, complete these instructions.

Exception list — Windows®

•

If you want to set preinstrumentor options that are specific to the JVM you are running:

Set the environment variable QUEST_PREINST_OPTS with the desired VM options. The environment variable QUEST_PREINST_OPTS is passed to the Java EE agent pre-instrumentor script.

For example, to set the memory limit for the pre-instrumentor to 256MB, specify the following: QUEST_PREINST_OPTS=-Xms256m.

Integrating on a Windows operating system

To integrate the Java EE agent with Tomcat on Windows:

Make a copy of the catalina.bat script.

By default, you can find this script in the <tomcat_home>\bin\ directory.

Complete a Generic installation only on Windows, as described in Create a Generic Installation for Manual Java EE Agent Integration .

Open the catalina.bat script in a text editor and update the script.

Immediately before the line:

if ""%1"" == ""debug"" goto doDebug

Insert the following block of code:

@rem set QUEST_PREINST_OPT=* OPTIONAL pre-instrumentor Options *
set QUEST_DEPLOYMENT_DIRECTORY=* SET JavaEE Installation Directory *
if ""%1"" == ""debug"" set QUEST_JAVA_ENV_OPTS=TOMCAT
if ""%1"" == ""run"" set QUEST_JAVA_ENV_OPTS=TOMCAT
if ""%1"" == ""start"" set QUEST_JAVA_ENV_OPTS=TOMCAT
if defined QUEST_JAVA_ENV_OPTS (
call "%QUEST_DEPLOYMENT_DIRECTORY:"=%\<integrate.cmd>"
)
if ERRORLEVEL 1 echo Quest Agent NOT enabled for Tomcat server

Set <integrate.cmd> to the name of the integration task you created in step 2. For example: integrate-Generic_installation_only_on_Windows_Install_Configs_and_pre-instrument.cmd.

Set the QUEST_DEPLOYMENT_DIRECTORY variable to the Installation directory specified by the Java EE Integration Agent instance activated on this host.


	IMPORTANT: Do not place quotation marks around the directory name even if it contains spaces. Doing so causes a conflict with existing quotation marks in commands that use the QUEST_DEPLOYMENT_DIRECTORY variable.

Save the modified startup script.

If it is not already running, start the Foglight Management Server. The instrumented Tomcat Server attempts to connect to the Management Server when the Tomcat Server is started using the modified script.

Use the modified script to start Tomcat.

The Foglight console confirms that a Tomcat Agent has connected by displaying a message similar to:

INFO Accepted connection from Tomcat Agent on <hostname>

In addition, the log file for the Tomcat Agent contains an INFO message stating that it has connected to the Management Server.


	IMPORTANT: By default, agent log files are created in the logs subdirectory of the Foglight home directory on the agent machine.

Configuring a Tomcat Windows Service that requires manual integration

If you have chosen not to specify the Java home, or you have set the Startup mode to jvm and Java to Use Default, complete the following procedure after an installation-only setup.

To manually integrate a Tomcat Windows® Service:

Complete a Generic installation only on Windows, as described in Create a Generic Installation for Manual Java EE Agent Integration . Specify the JVM used by the service in the Java_Home box in the setup wizard.

The generic installation creates a bootstrap.jar file and an integrationid that are needed later in this integration procedure.

Set the following Java options:

In a command prompt, open the Tomcat installation bin directory.

Type ./tomcat#w.exe //ES//<WindowsServiceIDname>.

For example:

./tomcat5w.exe //ES//Tomcat_Toronto_Host3.

In the Apache Tomcat Properties dialog box, open the Java tab.

Add the following options to the end of the list of existing Java Options:

-Dquest.debug=0

-Dquest.integrationid=<INTEGRATIONID>

-Xbootclasspath/p:<VERSIONED_SUBDIRECTORY>\bootstrap\<INTEGRATIONID>\<BOOTSTRAP_FILENAME>.jar

-javaagent:<VERSIONED_SUBDIRECTORY>\lib\performasure-agent.jar

Replace <VERSIONED_SUBDIRECTORY> with the absolute path of the deployment directory and the current agent directory version.

Example of a <VERSIONED_SUBDIRECTORY>:

C:\Dell Inc.\Foglight for Java EE Technologies_Agent_Manager\agents\JavaEE\5.7.0-570-20101210-1400

The Installation Directory is specified in the Java EE Integration Agent Startup Parameters, which you can see in the Edit Properties interface. 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.


	TIP: The current version of the subdirectory is indicated within the jee_builds.properties file. It is the value of the set.QUEST_AGENT_HOME parameter.This value already includes the installation directory. The version of the subdirectory portion is the last directory specified in the value.

Replace both instances of <INTEGRATIONID> with the integrationid produced in Step 1. The integrationid can be found in the integrate scripts generated by the generic installation, which are placed in the Installation Directory. Locate the scripts corresponding to your generic installation, open the .cmd script, and look for a command similar to the following:

@set QUEST_INTEGRATIONID=YourCustomizedId

where the word after the '=' is your integrationid. In this example, the integrationid is YourCustomizedId.

Replace <BOOTSTRAP_FILENAME> with the name of the pre-instrumentation .jar filename that was created in step 1. corresponds to the JRE/JDK that the Tomcat service uses. This name can be found in your agent machine bootstrap directory, in the <VERSIONED_SUBDIRECTORY>.

Here is an example where <INTEGRATIONID>, <VERSIONED_SUBDIRECTORY> and <BOOTSTRAP_FILENAME> are updated:

-Dquest.debug=0

-Dquest.integrationid=KEo3JDr6ALaybTu

-Xbootclasspath/p:C:\Quest_Software\Foglight_Agent_Manager\agents\JavaEE\5.9.3-20130815-0923\bootstrap\KEo3JDr6ALaybTu\C--Program_Files_-x86--Java-jdk1.6.0_20.jar

-javaagent:C:\Quest_Software\Foglight_Agent_Manager\agents\JavaEE\5.9.3-20130815-0923\lib\performasure-agent.jar

Click OK to save the changes to the Windows Service made within tomcat#w.exe.

Ensure that the Foglight Management Server is started and the Java EE agent is activated.

For the changes to take effect, stop and restart the Tomcat Windows Service.


	IMPORTANT: If the JVM that the Tomcat Windows Service uses is changed (for example, by installing an updated version of the JRE or JDK on the host), this manual integration must be done again. If Foglight for Java EE Technologies is updated on the Tomcat host, this manual integration must be done again to take advantage of the new release.

Manual integration with WebLogic

This section contains instructions for integrating the Java EE agent with a WebLogic® Server. You must modify your WebLogic startup script by adding lines to set the variables that the Java EE agent requires.


	NOTE: WebLogic versions earlier than 9.x do not provide Query Cache metrics for EJBs.

Before you begin

Review the following exceptions for variations before configuring your server.

Exception list

The following exceptions are not mutually exclusive. If all exceptions apply to your environment, complete all of the following instructions:

•

If you have spaces in the UNIX® QUEST_DEPLOYMENT_DIRECTORY path:

Edit the startup script and insert the following code in the Java command line before {SERVER_CLASS} or weblogic.Server:

•

WebLogic 9.x and 10.x:

"${PERFORMASURE_BOOTSTRAP}" "${PERFORMASURE_JAVA5}" ${PERFORMASURE_OPTIONS}

•

WebLogic 8.x:

"${PERFORMASURE_BOOTSTRAP}" ${PERFORMASURE_OPTIONS}

•

If you are using JRockit, and any one of the following conditions is true:

•

You are running the default WebLogic 8.1 startup scripts on any platform

•

You are running the default WebLogic 9.x or 10.x startup scripts on a Unix platform

•

You are using a customized startup script that does not place the WebLogic main class name into an environment variable

•

You are using a customized startup script that places the WebLogic main class into an environment variable other than SERVER_CLASS, but you have not provided the name of that environment variable to the integrate integration script (which is done by setting the additional environment variable APPSERVER_CLASS_VAR to the name of your custom environment variable.

For example, set APPSERVER_CLASS_VAR=WLS_MAIN_CLASS, if your custom mainclass variable is WLS_MAIN_CLASS).

Edit the startup script and insert the following code on the Java command line before weblogic.Server:

UNIX®:

${PERFORMASURE_BOOTAGENT}

Windows®:

%PERFORMASURE_BOOTAGENT%

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

Foglight for Java EE Technologies 5.9.9 - Installation Guide

Integrating with Tomcat on UNIX

Integrating with Tomcat on Windows

Configuring a Tomcat Windows Service that requires manual integration

Manual integration with WebLogic