Copyright 1998-2023 BMC Software, Inc. as an unpublished work. All rights reserved. Date: November 22, 2023 Product Name ========================================================== TrueSight Presentation Server TrueSight Infrastructure Management ProactiveNet Performance Management Supported Versions ========================================================== TrueSight Presentation Server 10.7.00 and higher TrueSight Infrastructure Management 10.7.00 and higher ProactiveNet Performance Management 9.6.00 (The tool will not perform a full analysis but will create reports to assist in migration to BMC Helix Operations Management) Type ========================================================== HealthCheck tool version 3.1 Webinar on running and understanding the Health Check Tool ========================================================== https://communities.bmc.com/community/bmcdn/helix/blog/2020/02/28/connect-with-truesight-running-and-understanding-tsom-health-check-tool-webinar Files contained in the tool ========================================================== utility/TrueSightHealthCheck/TrueSightHealthCheck.bat utility/TrueSightHealthCheck/TrueSightHealthCheck.sh utility/TrueSightHealthCheck/lib/health-check-tool-2.9.jar utility/TrueSightHealthCheck/conf/ directory that contains all configuration folders and XML utility/TrueSightHealthCheck/scripts/ directory that contains batch and shell scripts which tool executes 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% BMC Helix Operations Management (BHOM) Migration ========================================================== If you are in the process of planning a migration from ProactiveNet to BMC Helix Operations Management (BHOM), this tool can be run to obtain additional information. If you are in the process of planning a migration from TrueSight to BMC Helix Operations Management (BHOM), this tool can be run on TSPS with an additional parameter to obtain additional information. Please refer to separate file called readme.HelixEvaluate.txt. This additional parameter is not required for normal use of the tool. 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 with, 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 Executing the tool automatically ========================================================== The tool can be run automatically and the generated report emailed to the administrator. *NOTE this is available by default with the 11.3.07 TSOM version. The tool will run every Monday at 06:30. 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 /D %TRUESIGHTPSERVER_HOME%\utility\TrueSightHealthCheck TrueSightHealthCheck.bat -email TSIM: cd /D %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. TSPS: TRUESIGHTPSERVER_HOME= cd $TRUESIGHTPSERVER_HOME/utility/TrueSightHealthCheck sh TrueSightHealthCheck.sh -email TSIM: cd $BPPM_SERVER_HOME/utility/TrueSightHealthCheck sh TrueSightHealthCheck.sh -email Steps of uninstallation ========================================================== 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/reports directory ---------------------------------------------------------------------------------------------------------------------------------------------