TrueSight Operations Management Health Check Tool

Version 19
    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 assess the performance of the TrueSight Operations Management TSPS server and TSIM servers.

    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.


    Free disk space of approximately 500 MB

    Installing the tool

    1) Download the latest zip file from location
    2) For TSIM, extract the file into %BPPM_SERVER_HOME%
    3) For TSPS, extract the file into %TRUESIGHTPSERVER_HOME%

    Steps to execute the tool

    1) Open a command prompt, navigate to %BPPM_SERVER_HOME%/utility/TrueSightHealthCheck or %TRUESIGHTPSERVER_HOME%/utility/TrueSightHealthCheck and as the TrueSight User or the User you installed with, execute the following:


    User-added image

    User-added image

    2) Once the script has executed, it will advise to check the summary report under utility/TrueSightHealthCheck/reports e.g. Please check TrueSight health summary report at C:\Program Files\BMC Software\TrueSight\utility\TrueSightHealthCheck\reports\TSIM_TruesightHealth_2019082801530.html for more details.

    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.
    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 10 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 - executes the scripts used for netstat details OS patch levels, important version details, etc.. 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 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

      User-added image


    Article Number:


    Article Type:

    Product/Service Description

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