サポートと今すぐチャット
サポートとのチャット

Foglight for Java EE Technologies 5.9.11 - 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

WebSphere environments

WebSphere® are configured to use profiles. Therefore, configuration with the Java EE agent involves two steps. The first is to edit 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 following exceptions 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 256MB, specify the following:
Windows®:
QUEST_PREINST_OPTS=-Xms256m -Xmx256m
UNIX®:
QUEST_PREINST_OPTS=”-Xms256m -Xmx256m”
Configuring WebSphere environments

Complete the following steps to configure a WebSphere® environment.

To configure a WebSphere 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.

Creating WebSphere services

If you are starting your servers, Node agents, or WebSphere® Deployment Managers as a service, create a Windows® Service to use the Java EE agent instrumentation. See the IBM® documentation for instructions on creating and installing a Windows Service with the WASService.exe tool. You can keep your old Windows Service, but ensure that only one service for a particular WebSphere server, Node agent, or WebSphere Deployment Manager has a startup type of Automatic. All others should be set to Manual or Disabled.

When creating a Windows Service to integrate with the Java EE agent, provide an extra argument to the -startArgs option:

For WebSphere server use:

" -Dquest.agent.websphere.server"

For WebSphere Node agent use:

" -Dquest.agent.websphere.nodeagent"

For WebSphere Deployment Manager use:

" -Dquest.agent.websphere.dmgr"

* 
NOTE: Quotes are required. The space between the first quote and the dash is also required.

A caret (^) character is required at the end of a line (other than the last) to correctly wrap the DOS command on multiple lines. A space is a required before the caret character to ensure proper spacing when copying and pasting the following code blocks.
Examples:
WebSphere Server:

WAS_HOME\bin\WASService.exe -add "BASE server1 - with agent" ^
-servername server1 ^
-profilePath "C:\WebSphere6\profiles\AppSrv01" ^
-startArgs " -Dquest.agent.websphere.server" ^
-startType automatic

WebSphere Node agent:

WAS_HOME\bin\WASService.exe -add "ND nodeagent - with agent" ^
-servername nodeagent ^
-profilePath "C:\WebSphere6\profiles\AppSrv01" ^
-startArgs " -Dquest.agent.websphere.nodeagent" ^
-startType automatic

WebSphere Deployment Manager:

WAS_HOME\bin\WASService.exe -add "ND dmgr - with agent" ^
-servername dmgr ^
-profilePath "C:\WebSphere6\profiles\Dmgr01" ^
-startArgs " -Dquest.agent.websphere.dmgr" ^
-startType automatic

Modifying the WebSphere startup scripts

Use the steps in this section to modify the WebSphere startup scripts.

* 
NOTE: The following procedures are not required if you are starting your servers, Node agent, or Deployment Manager using Windows services.
Before you begin

Review the following exceptions 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 256MB, specify the following:
Windows:
QUEST_PREINST_OPTS=-Xms256m -Xmx256m
Unix:
QUEST_PREINST_OPTS=”-Xms256m -Xmx256m”
Modifying WebSphere startup scripts

Complete the following steps to modify a WebSphere startup script.

To modify the WebSphere startup scripts:
1
Locate your profile-specific startServer, startNode, or startManager script. Save a backup copy before continuing.
2
Open your profile-specific startServer, startNode, or startManager script. Before the call to the WebSphere Installation startServer, startNode, or startManager script, add the following environment variable as appropriate:
Windows:
a
In startServer add:
set QUEST_JAVA_ENV_OPTS=WEBSPHERE:SERVER
b
In startNode add:
set QUEST_JAVA_ENV_OPTS=WEBSPHERE:NODEAGENT
c
In startManager add:
set QUEST_JAVA_ENV_OPTS=WEBSPHERE:DMGR
Unix:
a
In startServer add:
QUEST_JAVA_ENV_OPTS=WEBSPHERE:SERVER
export QUEST_JAVA_ENV_OPTS
b
In startNode add:
QUEST_JAVA_ENV_OPTS=WEBSPHERE:NODEAGENT
export QUEST_JAVA_ENV_OPTS
c
In startManager add:
QUEST_JAVA_ENV_OPTS=WEBSPHERE:DMGR
export QUEST_JAVA_ENV_OPTS
3
Restart your application server. See, Restarting modified WebSphere servers.

Restarting modified WebSphere servers

After you have modified the startup script, restart the WebSphere® server.

To start the WebSphere modified server:
1
If it is not already running, start the Foglight Management Server.
2
Stop and restart the WebSphere server using the instructions for the server type you modified:
•
If you are using a standalone WebSphere server, stop the server and restart it with the modified script or the new Windows Service.
•
When starting WebSphere 6.x servers managed by a WebSphere Deployment Manager, stop the WebSphere node agent and restart the node agent with the modified script or with the new Windows Service. Restart any managed WebSphere Application Server instances after restarting the modified WebSphere node agent.
•
When starting a standalone WebSphere 7.x/8.x/9.0.0.x Server managed by a WebSphere Admin Agent, stop the WebSphere Admin Agent and restart the Admin Agent with the modified script or with the new Windows Service. Restart any managed WebSphere Application Server instances after restarting the modified WebSphere Admin Agent.
* 
CAUTION: For any server with a corresponding Windows service: Attempts to start a server by using a startup script may launch a Windows service instead. If the startup script is instrumented with the Foglight for Java EE Technologies, then the resulting WebSphere process is instrumented as well. Otherwise, the integration properties of the Service are used. This release changes the behavior of services launched as a result of a start script invocation.
* 
CAUTION: Foglight starts a Java EE agent for each instrumented server. When the Java EE agent connects to the Management Server, the Management Server console displays a message to confirm that a Java EE agent has connected. For example: INFO agent licenses assigned; Type: websphere, Host: <hostName>, CPUs: 1; CPU licenses in use: INFO Accepted DCE connection from agent "server1 (WebSphere)" (WebSphere 6.X). The log file for the Java EE agent also contains an INFO message stating that it has connected to the Management Server.

 

関連ドキュメント

The document was helpful.

評価を選択

I easily found the information I needed.

評価を選択