TrueSight Health Check Tool

The TrueSight Health Check Tool checks if your environment is optimized for performance and stability.

When you run the tool, it generates an HTML report that lists the actual and recommended values for parameters such as OS settings, database, logs, configuration files, and so on. 

Downloading the TrueSight Health Check Tool

In TrueSight Operations Management 11.3.03 and later, the TrueSight Health Check Tool is deployed as a part of the installation. You do not need to download it.

For previous versions of TrueSight Operations Management, you can download the TrueSight Health Check Tool from this  FTP location Open link  or from the knowledge article Open link

Tip: Check for the latest version

Newer versions of the TrueSight Health Check Tool might be developed after the initial release. It is recommended to check for the latest version of the tool at the FTP location or knowledge article.

Installing the TrueSight Health Check Tool

In TrueSight Operations Management 11.3.03 and later, the TrueSight Health Check Tool is deployed as a part of the installation. You do not need to install it.

For previous versions of TrueSight Operations Management, extract the downloaded file to the following location:

TrueSight Presentation Server



TrueSight Infrastructure Management



Running the TrueSight Health Check Tool

  1. As the user who installed TrueSight Operations Management, go to the following folder using a command prompt:  
    (TrueSight Presentation Server%TRUESIGHTPSERVER_HOME%\utility\TrueSightHealthCheck (Windows) or $TRUESIGHTPSERVER_HOME/utility/TrueSightHealthCheck (Linux).
    (TrueSight Infrastructure Management%BPPM_SERVER_HOME%\utility\TrueSightHealthCheck (Windows) or $BPPM_SERVER_HOME/utility/TrueSightHealthCheck (Linux).
  2. Run the following command:
    (Windows) TrueSightHealthCheck.bat
    (Linux) sh
  3. Check the summary report that is generated at utility\TrueSightHealthCheck\reports (Windows) or utility/TrueSightHealthCheck/reports (Linux).
    For example, C:\Program Files\BMC Software\TrueSight\utility\TrueSightHealthCheck\reports\TSIM_TruesightHealth_2019082801530.html.
    Using the recommendations from the generated report, you can reconfigure your system to improve performance and reliability.

TrueSight Health Check Tool validations

The command prompt displays the steps that are being processed by the TrueSight Health Check Tool. The following 10 steps are performed in the TrueSight Infrastructure Management Health Check Tool.

Step 1 - initializes the tool and sets environment variables needed for the tool.
Step 2 - validates the OS prerequisites for running the tool.
Step 3 - validates the OS configuration for running TrueSight Infrastructure Management. This validation is the same as the installer – checks OS, RAM, CPU, disk space, and so on.
Step 4 - validates the performance tuning parameters and includes heap settings, garbage collection settings, and so on.
Step 5 - validates the properties most commonly used in the product. It looks for duplicate parameters, CTRL-M characters, and so on.
Step 6-  validates to see if a particular message exists in the log file – any errors or concerns.
Step 7 - runs several checks against the database and checks Oracle tuning parameters, MFD counts, instance counts, and so on.
Step 8 - validates the ports between components and checks if there are any issues in connecting the TrueSight Infrastructure Management to the TrueSight Presentation Server.
Step 9 - executes the scripts used for netstat details, such as OS patch levels, important version details, and so on. The details are captured in the Summary Report.
Step 10 - consolidates all the reports generated in the steps above and creates the Summary Report. It displays the path to the report that was generated as a result of running the tool.

If any of these steps fail, the TrueSight Health Check Tool continues through the rest of the steps.

Uninstalling the TrueSight Health Check Tool

(TrueSight Presentation Server) Delete the folder %TRUESIGHTPSERVER_HOME%\utility\TrueSightHealthCheck (Windows) or $TRUESIGHTPSERVER_HOME/utility/TrueSightHealthCheck (Linux).

(TrueSight Infrastructure Management) Delete the folder %BPPM_SERVER_HOME%\utility\TrueSightHealthCheck (Windows) or $BPPM_SERVER_HOME/utility/TrueSightHealthCheck (Linux).

Was this page helpful? Yes No Submitting... Thank you


  1. Deepak Kamath

    Appreciate to add health check utility as part of installer / SP . Manual tasks and changes in server needs to be reduced

    Dec 23, 2019 10:17
    1. Sanjay Prahlad

      Hello Deepak, thanks for your feedback!

      Apr 29, 2020 01:47
  2. Venkata ramesh Ijjigani

    Really Nice tool which is giving more info

    Sep 14, 2020 10:27
    1. Sanjay Prahlad

      Hello Venkata, thanks for your feedback!

      Oct 15, 2020 12:24
  3. Roland Pocek

    hi, it would really be nice to mention the 3 possible switches to use with htc tool, and what they are doing and output they are delivering cheers rop

    Aug 22, 2023 01:46