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

Document created by RSA Customer Support Employee on Jun 11, 2018
Version 1Show Document
  • View in full screen mode

Article Content

Article Number000036360
Applies ToRSA Product Set: RSA Identity Governance & Lifecycle
Platform: WebSphere
 
IssueAny 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.
ResolutionFollowing 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.
       User-added image
  1. 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.

    User-added image


  1. 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.

    User-added image

 

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.



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

  1. 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.

   User-added image


   Rename folder to yourkit


  1. 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.

   User-added image


  1. In the Server Infrastructure section, expand Java and Process Management.
  2. Click the Process Definition hyperlink

    User-added image


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

   User-added image


  1. 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



    User-added image


  1. Click Apply.
  2. Click Save directly to the Master Configuration.

    User-added image


  1. Restart the WebSphere server.

  1. 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.
  2. 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.

   User-added image


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

  User-added image


  1. A Remote Application will be displayed.

   User-added image

 

  1. 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.

   User-added image


  • For example: Capture Memory

    User-added image


    User-added image


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

    User-added image


    User-added image


    User-added image


    User-added image


  1. 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.

    User-added image


    User-added image
Notes
 

Attachments

    Outcomes