IBM Support

How to profile WebSphere Portal Server for local and remote mode

Question & Answer


Question

How do you profile the remote and local WebSphere Portal Server(WPS) in IBM Rational Software Architect (RSA) / IBM Rational Application Developer (RAD)?

Answer

You can follow the steps below to profile local WPS and remote WPS from RAD/RSA.



Local profiling
  1. Make sure your RAD/RSA environment is ready:




  2. Enable the capabilities in RAD:




  3. Start Profiling:




  4. Choose the test server:




  5. Edit the filter:
    Need to pay attention, profiling will impact your server performance large degree. So, make sure filter out all the class you don't need.




  6. Then click finish to start profiling.
    System will automatically notice you to switch to profiling view to see the result, just click YES.




  7. From the profiling view, you will see the profiling result:





 

Remote Profiling


 
Install Agent controller
First, you need to install Agent Controller on the remote system where WPS installed. To get the Agent controller install images, please refer:
http://www-01.ibm.com/support/docview.wss?uid=swg27013420
 
For remote profiling, you need to set up the probekit on target WPS for gathering performance data.
Agent Controller is used for transferring data to RSA/RAD.

Install Probekit
Then, you need to install probekit on remote system where WPS installed.
Notes: You can install probekit from RAD or RSA.


 
Change the Portal start up parameter
First, you need to change the Generic JVM parameters. After login the Portal console, The application server must be started with profiling enabled. In the Administrative Console, navigate to Servers > Server Types > WebSphere application servers > WebSphere Portal> Java and Process Management > Process definition > Java Virtual Machine.
 
The purpose of this steps is making JVM to load probekit when it starts up.



 

 
For profiling with Java Profiling Agent, enter the following in the Generic JVM arguments field: -agentlib:JPIBootLoader=JPIAgent:server=controlled;CGProf
 
Apply and Save.
 
Change runtime environment
 
Update portal server start up script to add on profiler runtime variables:
 
Path: C:\Program Files\IBM\WebSphere\wp_profile\bin\setupCmdLine.bat
 
Add on: (Notes, the path must match your environment, and make sure Agent controller and probekit are in place)
 
REM Added by roberto for remote profiling
SET TPTP_AC_HOME=C:\PROGRA~1\IBM\SDP_AgentController\AgentController
SET JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler
SET PROBEKIT_HOME=C:\PROGRA~1\IBM\SDPShared\plugins\org.eclipse.hyades.probekit_4.3.3.v201104261357\os\win32\x86
SET BOOT_LOADER=C:\PROGRA~1\IBM\SDPShared\plugins\org.eclipse.tptp.platform.jvmti.runtime_4.6.4.v201105161135\agent_files\win_ia32
SET LD_LIBRARY_PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%LD_LIBRARY_PATH%;%BOOT_LOADER%
SET PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%JAVA_PROFILER_HOME%;%PATH%
REM End by roberto
 
restart portal server:
 
Note! When the Generic JVM arguments field is set for the Java Profiling agent, the server start appears hung because it is waiting for a signal from Rational Application Developer in this "controlled" profiling mode. Proceed to the next step.
 

 
Configure profiler in RAD/RSA
 
Make sure the Agent controller is started and 10002 port is listening:

 
Use netstat -ano | findstr 10002 to make sure the port is working:
 

 
 Run profile configure to start:
 

 
Configure the remote server by specifying the remote IP and port:
 

 
Click OK and test the connection to make sure the success.
 

 
Go to Agent tab, you will see the remote Portal Server listed, and edit the filter according to you requirement. Then click "apply" and "Profile" to start profiling
 

 
After you click "profile", RAD will automatically lead you to the "profile monitoring" perspective view, and you will see the profiling result from session summary. Below is the screenshot from my test environment.


 


[{"Product":{"code":"SS4JCV","label":"Rational Software Architect for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Java Development","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.5.1","Edition":"All Editions","Line of Business":{"code":"LOB15","label":"Integration"}}]

Document Information

Modified date:
16 June 2018

UID

swg21664281