Support Center > Search Results > SecureKnowledge Details
HealthCheck Point (HCP) Release Updates Technical Level
Solution

Click Here to Show the Entire Article
  • Introduction
  • Availability
  • List of Resolved Issues
  • Manual Installation
  • Uninstall
  • SmartConsole Extension Installation
  • Tests
  • What's The Story (WTS)
  • Topology
  • Usage
  • Revision History

 

Introduction

HealthCheck Point (HCP) is a self-updatable suite of tools for:

  • Tests: Assesses the health of your system
  • WTS (What's The Story): Provides a timeline of critical and informative events occurred on the system
  • Topology: Visualize the Firewall topology

HealthCheck Point supports all Gaia versions starting from R80.10.

 

Availability

Product Update # Release Date Download package
  • Quantum Security Gateways
  • Quantum Maestro
  • Quantum Scalable Chassis
  • VSX
  • Management Servers
  • Multi-Domain Servers
Update 7 - Take 49 17 Jan 2022 (TAR)

 

List of Resolved Issues and New Features per Update for HCP

ID Description
Update 7 - Take 49 (17 Jan 2022)
HCP-260 NEW: Added a test to validate Software Provision across Scalable Platforms cluster members.
HCP-291 NEW: Added HCP version and Take number to the HCP report.
HCP-324 NEW: Threat Prevention Heavy Connections test now shows 10 most loaded connections and connections load per instance.
HCP-325 NEW: Added 2 new tables to the Memory Usage test:
  • user space consumption per virtual system
  • total consumption per process (aggregated by name)
HCP-219 NEW: Added a test to check if the ICA certificate expires in less than a year/already expired. Refer to sk158096.
HCP-318 UPDATE: The Processes Memory test was removed. It is now part of the Memory Usage test.
HCP-292 Transceiver EEPROM data may cause an exception in HCP test.
HCP-297 In some scenarios, in a Scalable Platforms VSX environment, HCP may show an exception on test with Global Result option enabled.
HCP-299 Cluster members may appear twice in the test result.
HCP-303 Some zombie processes may not be detected by HCP test.
HCP-307 The SIC test output appears twice in the test result.
HCP-308 The CPView test may fail with an exception.
HCP-314 The Topology graph may fail to generate on systems with numbers or a dot (.) in the name.
HCP-317 The Transceiver test may fail with an exception.
HCP-342 The IDA Tables Mismatch test may fail with an exception.
Update 6 - Take 48 (9 November 2021)
HCP-210 NEW: Added to the Dmesg Errors test to handle the "stalls on CPU" messages.
HCP-209 NEW: Added the Bond Health test which validates that there are no slaves with different aggregator id under the same bond.
HCP-211 NEW: Added ports link integrity test for Maestro Orchestrator.
HCP-160 UPDATE: An error message will be displayed when trying to view report for the Security Management Server if the last report does not exist on the Security Gateway.
HCP-61 On VSX systems, the Topology graph of HCP report either does not display or shows incorrect information.
HCP-230 In some scenarios, the IDA Tables Limit test takes more than 5 seconds to run.
HCP-206 In some scenarios, the SecureXL Status test shows status [EXCEPTION].
HCP-224 In some scenarios, the SIC test may be skipped the Security Gateway connected to a Multi-Domain Management Server.
HCP-223 The "hcp --ext-update-reports all" command is not working properly on Multi-Domain Management environment.
HCP-208 The "FW Configuration File Sanity" report raises exception on some appliances like 16600t.
HCP-214 HCP "Core Dumps" may crash if there are broken headers in core dump archive.
HCP-207 The Feature Compatibility test may fail when "smo image auto-clone" is enabled.
HCP-205 In some scenarios, SmartConsole fails to open reports from the Management machine.
Update 5 - Take 46 (20 October 2021)
HCP-151 NEW: Added perf reports summary table to the CPU spikes performance test (listing top functions and processes during latest spikes).
HCP-158 NEW: Added HCP test to verify the IPv4 forwarding flag on FireWall interfaces.
HCP-106 NEW: Added HCP test to verify MTU values on FireWall interfaces.
HCP-30 NEW: Added basic filters and date navigation to What's The Story.
HCP-153 NEW:
  • Added hostname and date to the report file name
  • Added purge ability to delete old reports (archive are saved up to 10, and last reports the last one only).
HCP-198 NEW: Added new Threat Prevention Heavy Connections test.
HCP-192 NEW: Added new Threat Prevention tests to automate and improve the investigation of Threat Prevention performance issues.
HCP-202 NEW: Added the Threat Prevention protections impact test.
HCP-163 NEW: Added 3 new tests to the HCP tool:
  1. "IDA tables instances mismatch" - To check the number of mismatches between Identity Awareness kernel tables instances.
  2. "IDA tables limit" - For each Identity Awareness kernel table, to make sure the peak value is approaching the limit.
  3. "IDA tables mismatch" - To check the number of mismatches between Identity Awareness kernel tables.
HCP-193 In some scenarios, the connectivity to User Center may fail.
HCP-50 Improved the loading time of What's The Story events.
HCP-107 Local Logging test may fail even when remote logging setup is configured correctly.
HCP-166 The hcp.elg log file may show exceptions on some tests even if they did not run on the environment.
HCP-149 Typo in the Transceivers test.
HCP-38 When running HCP with custom VS "-c" flag, the VS number is displayed incorrectly in SmartConsole report.
HCP-162 HCP does not display a message when What's The Story does not contain events.
HCP-150 In some scenarios, the File Descriptors test fails with exception.
HCP-168 In some scenarios, after running HCP fails with error related to cpdiag stats.
HCP-188 Disabled WTS (What's The Story) and Topology when the specific test runs, unless specifically indicated that it should run WTS / Topology.
Update 3 - Take 44 (13 June 2021)
HCP-24 NEW: Added timestamp to HTML report.
HCP-16 NEW: Added the Transceiver Verifier test that checks that transceivers attached to appliances interfaces are supported.
HCP-82 NEW: Added a new CSV file to allow CPDiag to collect statistics for:
  • Number of times the HCP ran in this environment
  • Passed tests
  • Failed tests
  • Tests score
HCP-67 NEW: Added a new test to examine the SIC status between Security Management and Security Gateway. 
HCP-108 NEW: Added event of SNMP send failure to chassis modules to WTS (What's The Story).
HCP-93 NEW: Added a new test that checks Gaia database performance.
HCP-70 NEW: Added Support for HCP Extension on MDS
HCP-76 UPDATE: Search functionality in the HTML report is now under WIP and disabled.
HCP-29 UPDATE: Added the Threshold column to CPView.
HCP-26 UPDATE: WTS (What's The Story) will be displayed the HTML report by default.
HCP-100 UPDATE: Errors previously printed on the screen while tests are running will be printed to the hcp.elg file.
HCP-117 UPDATE: HCP test will alert about custom applications with signatures that may cause performance impact.
HCP-48 UPDATE: Help message is now displayed if the incorrect command syntax entered.
HCP-119 UPDATE: The Local Logging test is now disabled.
HCP-128 UPDATE: Added ability to run the fwkern.conf sanity test on each VS.
HCP-68 SecureXL status is missing in HCP test.
HCP-78 When running HCP with the wrong "-c" parameter, unnecessary blank HTML report is created.
HCP-64 The gexec command has a different default timeout value than hcpexec
HCP-96 Added more information to compatibility check of Forward Error Correction (FEC) feature.
HCP-97 The local logging test fails when a backup server is configured.
HCP-98 The Distribution test does not run from the Chassis Monitor.
HCP-53 Added core dumps information to WTS (What's The Story).
HCP-43 Cannot move between VSs in ARP CACHE limit test.
HCP-47 Charts tab time shows incorrect time.
HCP-71 The SIM Configuration File Sanity test may fail to find the kernel parameter although it exists.
HCP-89 Long words in the HCP test reports may cause overflow to adjacent table columns.
HCP-79 Added cosmetics fix to MSG Vlans consistency test: replace between the result table titles and add new line at the end of each missing VLAN
HCP-77 The Kernel Crash test shows "PASSED" although there are existing cores dump files.
HCP-129 In some scenarios, the Static Affinity Test fails with exception.
HCP-131 Scalable Platform Clients with ZETCLIENT process is shown as terminated and the Check Point Processes test status displays "ERROR". 
Update 2 - Take 29 (18 March 2021)
HCP-18 NEW: Added the Memory Usage (RAM) test, which analyzes the different memory sections and their current usage.
HCP-12 NEW: Added a compatibility test of configured features in Scalable Platform environments (based on sk148074).
HCP-15 NEW: Added --v / -version argument to display the Take number / RPM build of HCP.
HCP-11 NEW: Added ability to see a back trace of core dump files.
HCP-20 NEW: Added a new test that verifies that the distribution configurations between local members and SSMs are consistent.
HCP-13 NEW: Added a new test that confirms that logs are being written to a Log Server and not locally.
HCP-21 NEW: Added the Bond test and Corexl Status on VSX performance tests.
HCP-1 Running HCP on remote members using the "-m" flag is not available in Maestro environments.
HCP-23 Tests that are supposed to run only in Scalable Platform run in all environments.
HCP-17 The FW kern sanity test may fail when using parameter from type "uint".
Update 1 - Take 24 (18 February 2021)
ODU-81 Initial Release

 

Manual Installation (Offline)

HCP is installed automatically on all relevant Check Point devices, if the user allows the Automatic updates download per sk94508.
For users who do not allow automatic updates, HCP can be installed as described below.

Prerequisites: Install the latest Take of the AutoUpdater.
If you have issues with installing Autoupdater, contact Check Point Support for assistance.

 

  • Instructions for Security Gateways, VSX, Maestro Hyperscale Orchestrator and Management Servers

    Show / Hide this Section

    1. Download the latest HCP TAR from the Availability table.

    2. Run this command in the Expert mode:
      # autoupdatercli install <Full Path to the TAR Package>

    Note: The installation does not require a restart of Check Point services ("cpstop; cpstart") or a reboot. After it is installed, no further action is required. The future updates are be applied immediately.

  • Instructions for Maestro Gateways and Scalable Chassis R80.20SP and higher

    Show / Hide this Section

    1. Download the latest HCP TAR from the Availability table.

    2.  Copy the TAR to all other members by using the command
      # asg_cp2blades -b all <Full Path to the TAR Package>

    3. Run this command in the Expert mode:
      # g_all autoupdatercli install <Full Path to the TAR Package>

    4. Delete the TAR file from your system as it is no longer needed after installation.


Install Validation log

Make sure the package was correctly install.
View the log file located in the /opt/CPInstLog/AutoUpdateLogs/hcp/ directory and make sure the following lines appear:

 <HH:MM:SS>% :  Script /var/log/AutoUpdater/metadata/HealthCheck_Point/hcp/hcp_AutoUpdate/24/product_scripts/hcp_post_verify_action.sh output:
  [INFO] - verification endded successfully
 <HH:MM:SS>% :  Installation succeeded for component hcp
 <HH:MM:SS>% :  ----------------------------------------------------------------------

 

Uninstall

Run this command in the Expert mode: # autoupdatercli revert-completely hcp


Uninstall Validation log

Make sure the package was correctly uninstalled.
View the log file located in the /opt/CPInstLog/AutoUpdateLogs/hcp/ directory and make sure the following lines appear:

[SUCCESS] - Finish running hcp_unregister.sh
<HH:MM:SS>% :  Revert succeeded for component hcp
<HH:MM:SS>% :  ----------------------------------------------------------------------



SmartConsole Extension Installation


Prerequisites:

  1. Make sure the HCP package is installed on your Security Management Server
  2. Run the "hcp -r all" command at least once on each Security Gateway you want to see the report from.

Activating Extension on Security Management


Show / Hide this Section

Connect to your Security Management Server via SSH and run:
  1. # service hcp_ext start

  2. # hcp --ext-update-reports all
    • You must run this command on every restart of the Security Management Server to collect a report from the newly created  Security Gateway.



Adding Extension in SmartConsole


Show / Hide this Section
  1. Go to Manage & Settings -> Preference -> SmartConsole Extensions -> click "+":

  2. Enter the following as URL:  
    https://<your-management-ip>/ngm-management-app/hcp/extension.json:

     

  3. In the next prompt, click "Continue" and then "OK":
        


  4. You should see HCP extension added:



  5. Move to "Gateways & Servers", Choose your GW and click on "Health Check" button:

     


  6. HCP new window should pop up:

  7. To fetch the latest report from the Security Gateway or run it live on it, use one of the following options: "Fetch Latest" Report or "Fetch Live Report":

     


Tests

  • Self-diagnostics utility program that executes a set of tests.
     
  • Tests scan the system and can detect:
    • Feature/system configuration bad practices
    • Foresee future issues that may affect the system
    • Historical issues that may re-occur
  • Provide a comprehensive structured system assessment report:
    • Include each of the tests and a final verdict (Success/Error/Warning)
    • Tests that failed show their findings and suggest a next-step action

     

 

What's The Story (WTS)

  • WTS tells the story of the system by arranging critical/informative events into a timeline
  • WTS combines events of several processes and services into a single timeline which gives a bird-eye vision
  • WTS become helpful when troubleshooting issues that affected the system but no longer exists (RCA)
  • WTS events can be extended
   

 

Topology

  • Visualize the firewall topology in the network

  • Very helpful with complex VSX environments
 

 

Usage

Default manual run: # hcp -r all --include-wts yes

Syntax:

# hcp {-r | --run} {all | "test 1" "test2" ...} [{-f | --format} <json | table>] [{-o |--output-file} </Path/To/Output-File>]

# hcp {-l | --list-tests} [{-f | --format} <json | table>]

# hcp {-r | --run} [{-m | --members} {all| 2_1-2_3}]
  (for Scalable Platforms only)


Parameters:

Parameter Parameter Status Parameter Description
-h | --help Optional  Shows the built-in help and exits
-r {all | "test 1" "test2" ...}
--run {all | "test 1" "test2" ...}
Mandatory  Runs all or only the specified HealthCheck Point (HCP) tests
-l |--list-tests Mandatory  Lists all tests
-s |--silent Optional  Runs in a silent mode (no stdout)
--show-last Optional  Shows a full report for the last test
--include-topology {yes|no} Optional  Includes the topology in the JSON output
--include-wts {yes|no} Optional  Includes the "What's The Story" information in the JSON output
--include-charts {yes|no} Optional  Includes the history charts in the JSON output
-o </Path/To/Output-File>
--output-file </Path/To/Output-File>
Optional  Specifies the path and name of the output file
-f {json|table}
--format {json|table}
Optional  Output display format - JSON, or table (default)
--cli-list-tests Optional  Shows all available tests
-m {all| 2_1-2_3}
--members {all| 2_1-2_3}
Optional  Available on Scalable Platforms / Maestro. Runs the tool on all members.


To view report in CLI:
# hcp --show-last | more

To view report in Web browser:

  1. Copy the /var/log/hcp/last/hcp_last_report.tar.gz file to your personal computer
  2. Extract the TAR content
  3. Open the index.html file in your web browser

 

Revision History

Show / Hide revision history

Date Description
17 Jan 2022 Released Update 7 - Take 49
09 Nov 2021 Released Update 6 - Take 48
20 Oct 2021 Released Update 5 - Take 46
16 Jun 2021 Added the "SmartConsole Extension Installation" section
13 Jun 2021 Released Update 3 - Take 44
18 Mar 2021 Released Update 2 - Take 29
18 Feb 2021 First release of this document - Update 1 - Take 24

Give us Feedback
Please rate this document
[1=Worst,5=Best]
Comment