BMC has developed a Health Check Tool to help customers ensure the configuration is to BMC Best Practices and self-solve common problems of the TrueSight Presentation Server (TSPS) and TrueSight Infrastructure Management (TSIM) servers.

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



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 in accordance with 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 ftp://ftp.bmc.com/pub/TSOM/HealthCheck/ or directly from this Knowledge Article or from this link here or from EPD under TrueSight Presentation Server 11.3.07.

NOTE: Use Internet Explorer, Edge or Firefox browser to open the above ftp link as it may not work with Chrome browser. Alternatively, use an ftp client such as FileZilla.

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 or EPD for the latest version to be used. The current version is 3.1.

If you choose to run on the TSPS, download it 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 ftp://ftp.bmc.com/pub/TSOM/HealthCheck

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
===================================

1a) To run the HealthCheck and automatically email the report to the administrator-defined to receive self-monitoring email alerts for TSIM/TSPS, open a command prompt and navigate to:

%BPPM_SERVER_HOME%/utility/TrueSightHealthCheck
Or
%TRUESIGHTPSERVER_HOME%/utility/TrueSightHealthCheck

As the user that TSIM/TSPS was installed with, execute the following:

TrueSightHealthCheck.bat -email
Or 
sh TrueSightHealthCheck.sh -email

1b) To just run the HealthCheck, open a command prompt and navigate to:

%BPPM_SERVER_HOME%/utility/TrueSightHealthCheck
Or
%TRUESIGHTPSERVER_HOME%/utility/TrueSightHealthCheck

As the user that TSIM/TSPS was installed, execute the following:

TrueSightHealthCheck.bat
Or 
sh TrueSightHealthCheck.sh

*NOTE For TSPS only, if a log4j patch has been installed then it will be necessary to set LOG4J_V environment variable first before running the above if the log4j version is not 2.17.1. For example:

Linux:
export LOG4J_V=2.17.0

Windows:
set LOG4J_V=2.17.0





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.





Executing the tool automatically
===================================
The tool can be run automatically and the generated report emailed to the administrator.

Ensure that you have configured the administrator email. For more information, see https://docs.bmc.com/docs/tsps11304/monitoring-the-presentation-server-environment-938215112.html for TSPS and https://docs.bmc.com/docs/TSInfrastructure11304/configuring-e-mail-settings-to-receive-alerts-937359842.html for TSIM.

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

TSPS:
cd %TRUESIGHTPSERVER_HOME%\utility\TrueSightHealthCheck
REM specify drive that TSPS is installed on if it is not installed on C:
D:
TrueSightHealthCheck.bat -email

TSIM:
cd %BPPM_SERVER_HOME%\utility\TrueSightHealthCheck
REM specify drive that TSIM is installed on if it is not installed on C:
D:
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.

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

TSIM:
cd $BPPM_SERVER_HOME/utility/TrueSightHealthCheck
sh TrueSightHealthCheck.sh -email

Steps to uninstall
===================================
TSIM:
Delete the folder %BPPM_SERVER_HOME%/utility/TrueSightHealthCheck

TSPS:
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.
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Watch the video which covers how to interpret the results of Health Check Tool:



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