Setting up IBM Health Center for your runtime test environment

Complete the following steps to set up IBM Health Center for your runtime test environment.

You can analyze the Health Center data that is collected in headless mode by using the Health Center client (see Installing Health Center).

Tip: As an alternative to the Health Center client, you can use the HCL Commerce Health Center Report tool. This tool uses the Health Center file (.hcd) to generate a web-based report of the performance data with insights that are specific to HCL Commerce. For more information, see HCL Commerce Health Center Report.

Procedure

Complete the followings steps to enable the Health Center agent in headless mode in the Transaction server.
  1. Open the WebSphere Application Server Administration Console.
    For example,
    https://yourserver:9043/ibm/console
  2. Select Servers.
  3. Expand Server Type and then click WebSphere application servers.
  4. Click the name of your server.
  5. Expand Java and Process Management and then click Process Definition.
  6. Under the Additional Properties section, click Java Virtual Machine.
  7. Scroll down and locate the Generic JVM arguments field.
  8. Add the following arguments in a single line: 
    -Xhealthcenter:level=headless 
-Dcom.ibm.java.diagnostics.healthcenter.headless.output.directory=${SERVER_LOG_ROOT}/healthcenter 
-Dcom.ibm.java.diagnostics.healthcenter.headless.run.duration=15 
-Dcom.ibm.diagnostics.healthcenter.data.profiling=off 
-Dcom.ibm.java.diagnostics.healthcenter.allocation.threshold.low=10000000
-Dcom.ibm.java.diagnostics.healthcenter.stack.trace.depth=20
-Dcom.ibm.java.diagnostics.healthcenter.headless.files.to.keep=0

    For more information, see Health Center Configuration Properties.

Complete the following steps to update the Liberty server's generic JVM arguments in your Store, Search, and Customization (xC) containers.
  1. Enter the Docker containers.
    For example,
    docker exec -it <container_name> bash
  2. Edit /profile/jvm.options and add the following code. Edit values if needed. 
    -Xhealthcenter:level=headless
-Dcom.ibm.java.diagnostics.healthcenter.headless.output.directory=/profile/logs/healthcenter
-Dcom.ibm.java.diagnostics.healthcenter.headless.run.duration=15
-Dcom.ibm.diagnostics.healthcenter.data.profiling=off
-Dcom.ibm.java.diagnostics.healthcenter.allocation.threshold.low=10000000
-Dcom.ibm.java.diagnostics.healthcenter.stack.trace.depth=20
-Dcom.ibm.java.diagnostics.healthcenter.headless.files.to.keep=0
  3. Save the changes.
  4. Restart the containers.

Health Center continuously creates healthcenter*.hcd files in the directory that is specified by the output.directory property at the interval that is set by the run.duration property. The default interval is 15 minutes.

  1. When needed, fetch the healthcenter*.hcd from the container to your local server by using docker cp.
    For example,
    docker cp <container>:<path_to_logs> <local_destination>