IBM Support

Health Center Client

How To


Summary

The IBM Monitoring and Diagnostic Tools - Health Center client tool analyzes live or postmortem Java performance data produced by the Health Center agent for IBM Java.

Steps

The Health Center agent ships with IBM Java. In general, the overhead of enabling the agent is less than 2%. There are two ways to enable the Health Center agent: 1) a live socket mode, and 2) a headless mode that writes data to files. The data produced by the agent in either mode may be consumed by the Health Center client that can be downloaded with the following instructions.
  1. Ensure IBM Semeru Runtimes Java 17 (choose the "JDK" option on the download page instead of "JRE") is on your PATH.
  2. Download Health Center:
    1. Windows x86_64/amd64
    2. macOS x86_64/amd64
    3. macOS arm64/aarch64
    4. Linux x86_64/amd64
    5. Linux arm64/aarch64
    6. Linux POWER/ppc64le
    7. Eclipse archived update site
    8. monitoringapi.jar
  3. For macOS, before extracting, open Terminal, change directory to the download folder, and run:
    xattr -d com.apple.quarantine *
  4. Start Health Center by executing healthcenter.exe (Windows), Eclipse.app (macOS), or healthcenter (Linux)
Ensure a large -Xmx if loading large HCDs. To change JVM parameters, edit healthcenter.ini (Windows/Linux) or Eclipse.app/Contents/Eclipse/healthcenter.ini (macOS).

Additional Information

Revision History
  • 2024-07-09: Update to Eclipse 2024-06 and fix issues with monitoringapi.jar
  • 2024-01-08: Update to Eclipse 2023-12
  • 2023-12-04: Add Eclipse archived update site and monitoringapi.jar
  • 2023-08-14: Clarify which Semeru build to download.
  • 2023-06-06: Upgrade to Eclipse 2023-03 and Java 17
  • 2022-07-19: Upgrade to Eclipse 2022-06 and Java 11
  • 2022-04-25: Comment out BlueMix connector to remove Spring dependencies with CVEs
  • 2021-12-29: First version
These downloads are provided as is without any warranty or support. For any issues, contact Kevin Grigorenko (kevin.grigorenko@us.ibm.com) and we'll try to resolve any issues as time permits.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m3p000000F7ylAAC","label":"IBM WebSphere Liberty-All Platforms-\u003ELiberty Profile-\u003EHang Performance CPU"},{"code":"a8m50000000CdBVAA0","label":"WebSphere Application Server traditional-All Platforms-\u003EHang Performance CPU"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG9NGS","label":"IBM Java"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
10 July 2024

UID

ibm16537532