지금 지원 담당자와 채팅
지원 담당자와 채팅

Foglight for Java EE Technologies 5.9.7.5 - Installation Guide

Installing and Configuring Foglight for Java EE Technologies Integrating with JBoss Integrating with Tomcat Integrating with WebLogic Domain Startup Scripts Integrating with WebSphere Integrating with Oracle AS 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 Installations Foglight for Java EE Integration Configuration FAQ and Troubleshooting Performing Manual Application Server Integrations Appendix: Managing Permissions for the Java EE Integration Agent Appendix: Foglight for Java EE Application Methods

Configuring the WebSphere 6.x and 7.x environment

* 
IMPORTANT: Review the section Understanding What Should Be Instrumented before you begin manually integrating WebSphere.
This section contains instructions for integrating the Java EE agent with WebSphere Server versions 6.1, 6.1 ND, 7.0 and 7.0 ND. You either need to create new Windows services that start instrumented servers, Domain agent (version 7.x only), Node agents, and WebSphere Deployment Managers, or modify the startup scripts.
If you want to instrument the servers that are started by a Node agent, you must configure integration with the Node agent.
If you want to collect cell-wide configuration information and application server states, you must configure the integration with the WebSphere Deployment Manager.
Using Foglight for Java EE Technologies with your WebSphere 6.x and 7.x servers requires three steps:
1
Configuring the WebSphere 6.x and 7.x environment .
2
Creating New WebSphere 6.x and 7.x Services .
3
Modifying the WebSphere 6.x and 7.x Startup Scripts .
Other topics include:
•
Running WebSphere with Security Enabled
•
Setting the PMI Levels on WebSphere 6.x and 7.x
* 
CAUTION: Before you attempt to integrate WebSphere 6, ensure that the Disable JIT check box is not selected on the Java Virtual Machine page in the WebSphere Administrative Console. Disabling the JIT drastically slows down the server’s startup and operation.Disabling metrics or changing metric sets while you are collecting data is not recommended. If you do so, Foglight may be unable to collect the necessary WebSphere metrics. In addition, if you disable metrics or change metric sets while data collection is in progress, Foglight cannot restore the original set of metrics that you configured.

Configuring the WebSphere 6.x and 7.x environment

WebSphere 6.x and 7.x are configured to use profiles. Therefore, configuration with the Java EE agent involves two steps. The first is to make modifications to the global setupCmdLine script. These changes only take effect if the environment variable QUEST_DEPLOYMENT_DIRECTORY has been set in your user profile setupCmdLine script. All other profiles ignore the code in the global setupCmdLine script.

Before You Begin

Review the exceptions listed below before you configure your server.
Exception List
•
If you want to set pre-instrumentor options 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 used for the pre-instrumentor to 256 MB, specify the following:
Windows:
QUEST_PREINST_OPTS=-Xms256m -Xmx256m
Unix:
QUEST_PREINST_OPTS=”-Xms256m -Xmx256m”

Configuring WebSphere 6.x and 7.x Environments

Complete the following steps to configure a WebSphere 6.x and 7.x environment.
To configure a WebSphere 6.x and 7.x environment:
1
Make a backup copy of your original global setupCmdLine script (.bat or .sh).
By default, this script can be found in the <websphere_home>/bin/ directory.
2
Create a Generic Installation Only integration on the host. For more information, see Creating a Generic Installation for Manual Java EE Agent Integration.
3
Open the global setupCmdLine script in a text editor and make the following modifications:
•
Windows Only — Add the following code to the end of the script:
if %1==-Dquest.agent.websphere.server set QUEST_JAVA_ENV_OPTS=WEBSPHERE:SERVER
if %1==-Dquest.agent.websphere.nodeagent set QUEST_JAVA_ENV_OPTS=WEBSPHERE:NODEAGENT
if %1==-Dquest.agent.websphere.dmgr set QUEST_JAVA_ENV_OPTS=WEBSPHERE:DMGR
Add the following code before the line goto :EOF:
if defined QUEST_DEPLOYMENT_DIRECTORY if defined QUEST_JAVA_ENV_OPTS (
call "%QUEST_DEPLOYMENT_DIRECTORY%\<integrate.cmd>"
if ERRORLEVEL 1 echo Java EE agent NOT enabled
)
•
Unix — Add the following code to the end of the script:
if [ -f "$QUEST_DEPLOYMENT_DIRECTORY/<integrate.sh>" -a -n "$QUEST_JAVA_ENV_OPTS" ];
then
. "$QUEST_DEPLOYMENT_DIRECTORY/<integrate.sh>"
else
echo Java EE agent is NOT enabled
fi
4
Set <integrate.cmd/sh> 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.
5
Save your modified setupCmdLine script file.
6
Locate your profile setupCmdLine script. The default installation places it in WAS_HOME/profiles/<profile_name>/bin. Set the QUEST_DEPLOYMENT_DIRECTORY at the end of the profile script to the Installation directory defined in step 2 to enable monitoring for that profile.
Windows:
rem Enable Java EE agent monitoring for this profile
set QUEST_DEPLOYMENT_DIRECTORY=* SET JavaEE Installation Directory *
Unix:
# Enable Java EE agent monitoring for this profile
QUEST_DEPLOYMENT_DIRECTORY=* SET JavaEE Installation Directory *
export QUEST_DEPLOYMENT_DIRECTORY
7
Save the changes to your profile-specific setupCmdLine script.
8
Restart your application server.
관련 문서

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택