TrueSight Operations Management Health Check Tool

Version 204
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    TrueSight Operations Management


    TSIM Application Server


    TrueSight Operations Management 10.7 and higher


    BMC has developed a Health Check Tool to help customers ensure configuration is to BMC Best Practices and self solve common problems of the TrueSight Operations Management TSPS server and TSIM servers.

    There is a webinar on running and understanding the Health Check Tool on

    The Health Check Tool will review the TSIM/TSPS environment and compare it to the desired tuning recommendations based on the size of the environment and using the BMC Documentation for tuning.

    The tool is quick and easy to download and run and there is a tool for both TSPS and TSIM servers.
    Users can download the Health Check Tool from the FTP site or directly from this Knowledge Article. The file would need to be downloaded to the TrueSight Operations Management component you want to verify. 
    NOTE: This tool is a living tool and may be updated at will, so BMC recommends checking the FTP link above or this Knowledge Article for the latest version to be used.

    If you choose to run on the TSPS, download to the TSPS, if you choose to run on the TSIM server, download the file to the TSIM server. We would recommend running on both TSIM and TSPS servers in the environment.

    Although the tool does not require TSPS/TSIM to be running when it is executed, it will provide more detail if they are.

    Installing the tool

    1) Download the latest zip file from location

    2) For TSIM, as the same user that installed TSIM, extract the file into %BPPM_SERVER_HOME%

    3) For TSPS, as the same user that installed TSPS, extract the file into %TRUESIGHTPSERVER_HOME%

    Steps to execute the tool

    1) Open command prompt, navigate to %BPPM_SERVER_HOME%/utility/TrueSightHealthCheck or %TRUESIGHTPSERVER_HOME%/utility/TrueSightHealthCheck
    and as the user that TSIM/TSPS was installed with, execute the following:


    User-added image

    User-added image

    2) Once the script has executed, it will display the number and severity of issues found and advise to check the summary report under utility/TrueSightHealthCheck/reports. For example:

    1 CRITICAL 3 ERROR issue(s) found.

    Please review the TrueSight Health Check Summary report at C:\Program Files\BMC Software\TrueSight\utility\TrueSightHealthCheck\reports\TSIM_TruesightHealth_20200609100646_tsim001.html

    3) Review the summary report and action any item which has a severity of CRITICAL, ERROR or WARNING.

    User-added image

    User-added image

    Steps to uninstall
    Delete the folder %BPPM_SERVER_HOME%/utility/TrueSightHealthCheck

    Delete the folder %TRUESIGHTPSERVER_HOME%/utility

    If you have any questions about execution of tool, contact BMC Customer Support and provide zip of the TrueSightHealthCheck/logs and TrueSightHealthCheck/reports directories.

    A brief look at what the Health Check Tool does on the TSIM server

    Copy the tool to the TSIM server, and then execute the tool by running the .bat or .sh script mentioned in the readme.
    The command prompt will show the steps which are being processed by the Health Check tool. There are 11 steps taken in the TSIM Health Check Tool

    Step 1 - initializes the tool – sets environment variables needed for the tool
    Step 2 - validates the OS prerequisites for running the Health check tool
    Step 3 - validates the OS configuration for running TSIM – the same as the installer – checks OS, RAM, CPU, disk space, etc
    Step 4 - validates the performance tuning parameters as per our documentation. It includes heap settings, garbage collection settings, etc..
    Step 5 - validates the properties most commonly used in the product (TSIM) – looks for duplicate parameters, Control M characters, etc
    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 will check Oracle tuning parameters, MFD counts, instance counts, etc.
    Step 8 - validates the ports between components and will validate if there are any issues in connecting the TSIM to the TSPS tool
    Step 9 - validates the other node is running (only applicable to HA)
    Step 10 - executes the scripts used for netstat details OS patch levels, important version details, etc.. the details are captured in the Summary Report
    Step 11 - consolidates all the reports generated in the steps above and creates the Summary Report – it will show the path to the Report which was generated as a result of running the tool

    If any of these steps fail, the Health Check Tool will continue past the step which failed but can continue through the rest of the steps.

    There is a reports folder created and the summary report will show in the reports folder with the timestamp. Open the report in either a Browser or via Excel

    User-added image



    Article Number:


    Article Type:

    Product/Service Description

      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles