How to install and configure YourKit Java Profiler Client and Remote Agent for using in profiling RSA Identity Governance & Lifecycle installations on WebSphere.

[#1]

Article Number

000036360

Applies To

RSA Product Set: RSA Identity Governance & Lifecycle
Platform: WebSphere
 

Issue

Any performance issues relating to RSA Identity Governance & Lifecycle User Interface and Data Collections, etc. are found in the WebSphere environment. 

The RSA Engineering team will require more information about memory and CPU on a WebSphere environment. Therefore, they will request data captures and  snapshots via YourKit.

Resolution

Following are instructions for installing and configuring the YourKit Java Profiler Client and Remote Agent for WebSphere:

1. Download the software for both Windows and Linux X64 from the YourKit download page.

       Image description

2. Install the YourKit Java Profiler Client:
   1. The Windows install file is named YourKit-JavaProfiler-<date>-<build>.exe.  For example, YourKit-JavaProfiler-2018.04-b64.exe.
   2. Install it on a Windows host that is on a subnet/network that can route to the RSA Identity Governance & Lifecycle server or appliance.  The installation will prompt for a destination for the software.

    Image description

3. Click Get Free Evaluation Key at first launch. This will send you to a web page on YourKit’s website that prompts for an email address to which they send the evaluation key.

    Image description

 

Note: If the Windows host that can access the RSA G&L server cannot reach the web, simply install the software on another host that has web access to get the ASCII key.

4. The prompt to integrate with IDE can be cancelled, as it is not needed for this exercise.

3. Install the Remote Agent to the WebSphere host
   1. Use a secure FTP client such as FileZilla or WinSCP to copy the YourKit-JavaProfiler-<date>-<build>.zip, to the WebSphere server.
   2. Unzip the file to a path, such as /home/oracle/yourkit.

   Image description

   Image description

4. Configure WebSphere to utilize the Remote Agent.
   1. Logon to the Administrative Web User Interface for WebSphere. 
   2. Under Servers > Application Servers, click on the server instance hyperlink.

   Image description

3. In the Server Infrastructure section, expand Java and Process Management.
4. Click the Process Definition hyperlink

    Image description

5. Under Additional Properties on the right, click the Java Virtual Machine hyperlink.

   Image description

6. In the Generic JVM arguments window, append to the existing value with the following string:

-agentpath:/home/oracle/yourkit/bin/linux-x86-64/libyjpagent.so=listen=all

    Image description

7. Click Apply.
8. Click Save directly to the Master Configuration.

    Image description

9. Restart the WebSphere server.

5. The YourKit Java Profiler on a Windows host will communicate to the WebSphere server on its default TCP port of 10001.  This port needs to be open on the WebSphere server's firewall.
6. Create a Monitor Remote Application to collect snapshots.
   1. ​Launch YourKit Java Profiler from the Windows host’s Start menu. 
   2. In the bottom left under Monitor Applications, click Connect to remote application.

   Image description

3. In the dialog, enter the server's hostname or IP and port number.  When done, click OK.

  Image description

4. A Remote Application will be displayed.

   Image description

 

6. The setup of YourKit Java Profiler is complete.

Additional steps to capture the snapshot

1. There are a series of buttons that have the universal green Play icon.  When the Play icon is clicked, that component is being monitored.  When the Play icon is selected, it turns to the universal Stop icon.  Clicking Stop halts the monitoring.  Under each component is additional parameters for granularity.

   Image description

• For example: Capture Memory

    Image description

    Image description

2. At any time, after one or more components have been collecting data, the floppy disk icon can be clicked to generate a snapshot.

    Image description

    Image description

    Image description

    Image description

3. To see or set where the snapshots will be stored locally on the Windows host:
   1. In the toolbar, mouse over the floppy disk icon.
   2. From the Capture Memory Snapshot popup, click on the hyperlink for Snapshot Directory.

    Image description

    Image description

Notes