TrueSight Health Check Tool

The TrueSight Health Check Tool checks for the following:

  • If your environment is optimized for performance and stability.
  • If your environment has upgrade impact issues. 

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

For TrueSight Operations Management version 11.3.04 or earlier, you need to download the latest version of the TrueSight Health Check Tool.

You can download the tool from this  FTP location Open link  or from the knowledge article Open link

Installing the TrueSight Health Check Tool

For TrueSight Operations Management version 11.3.04 or earlier, you need to install the latest version of the TrueSight Health Check Tool by extracting 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.

Scheduling the report email

You can schedule the generated TrueSight Health Check Tool report to be emailed automatically to the administrator.

Ensure that you have configured the administrator email. For more information, see for  Presentation Server Open link  and  Infrastructure Management. Open link

On Windows:

  1. Create a batch file with the following content in a folder that is outside the product installation folder. 

    Presentation Server
    cd %TRUESIGHTPSERVER_HOME%\utility\TrueSightHealthCheck
    TrueSightHealthCheck.bat -email
    Infrastructure Management Server
    cd %BPPM_SERVER_HOME%\utility\TrueSightHealthCheck
    TrueSightHealthCheck.bat -email
  2. Schedule a task in the Windows task scheduler to run as per your requirement. BMC recommends to schedule it weekly. Provide the path of the batch file as the execution program.

On Linux:

Create a crontab scheduler as per the following sample shell file in a folder that is outside the product installation folder. 

When you create the crontab, make sure that it is applicable to the Presentation Server user. Test the shell and batch file manually before you add it in the scheduled task and crontab.

Presentation Server
TRUESIGHTPSERVER_HOME= <The Presentation Server install directory. For example: /opt/bmc/TrueSightPServer>
cd $TRUESIGHTPSERVER_HOME/utility/TrueSightHealthCheck
sh -email
Infrastructure Management Server
cd $BPPM_SERVER_HOME/utility/TrueSightHealthCheck
sh -email

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 - validates the other node is running (only applicable to HA).
Step 10 - 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 11 - 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