Intel® Cluster Checker Release Notes and New Features

Published: 10/13/2017  

Last Updated: 06/22/2021

This page provides the current Release Notes for Intel® Cluster Checker. The notes are categorized by major version, from newest to oldest, with individual releases listed within each version.

Click a version to expand it into a summary of new features and changes in that version since the last release, and access the download buttons for the detailed release notes, which include important information, such as pre-requisites, software compatibility, installation instructions, and known issues.

You can copy a link to a specific version's section by clicking the chain icon next to its name.

To get product updates, log into the Intel® Software Development Products Registration Center.
For questions or technical support, visit Intel® Software Developer Support.


Linux* Release Notes

  • Added a dependency tree for framework definitions to display the hierarchy of included framework definitions
    • Added tree at the top of '-X <FWD name>' output
    • Added tree as a section in the results output file
  • Environment variable path expansion handling added to Framework Definitions
  • Bug fixes and improvements
  • Improved providers and parsing to account for newest output changes
  • Updated third-party SQLite3*, IOzone*, CZMQ*, and ZeroMQ* libraries to latest stable versions
  • A CVE with SQLite3 was patched and fixed, CVE-2021-36690

Linux* Release Notes

  • Intel® Cluster Checker 2021.3 includes new enhancements and bug fix for:
    • Improvements to the environment modulefile and script
    • Fixed a bug related to MPI workload execution. Benchmarks using Intel(R) MPI Library or MPICH will maintain the environment (variables) when running with the MPI collect extension
    • Cleanup of unneeded environment variables from providers:
    • Software Development Kit: Added missing header file to SDK include directory
    • Latest libxml2 2.9.12 included addressing CVE-2021-3541 & previously patched CVE items.
    • Analysis of IMB_pingpong extension uses latest collected data for analysis
    • Environment propagation no longer propagates the local-only PROFILEREAD (readonly variable) and LC_* (locale settings) environment variables​

Linux* Release Notes

  • This latest Intel® Cluster Checker release adds support for:
    • Support for Third Generation Intel® Xeon® Scalable processors
    • Support for Intel® HPC Platform Specification 2.0
    • Support for Intel® Select Solutions for Simulation and Modeling 2021.0 including new framework definitions:
      • select_solutions_network_performance
      • select_solutions_sim_mod_benchmarks_plus_2021.0
      • select_solutions_sim_mod_priv_plus_2021.0
      • select_solutions_sim_mod_user_plus_2021.0
    • A CVE with SQLite3 was patched and fixed, CVE-2021-20227.

Linux* Release Notes

  • Improved execution of HPL and HPCG with mpirun launch command on workload managed systems (e.g. Slurm)
  • Intel(R) Ethernet 800 series support (intel_ethernet800_* frameworks)
    • driver checks and version uniformity
    • required libraries
    • memlock unlimited check
    • PCIe checks
  • setvars scripts compatible with mksh environments

Linux* Release Notes

Intel(R) Cluster Checker Version 2021 Update 1 represents several significant improvements from the last major revision of Intel(R) Cluster Checker Version 2019. Many of the modifications and improvements listed below have been introduced  in subsequent updates to Intel(R) Cluster Checker Version 2019 over the past year, and included in beta releases for Version 2021, the following is a compilation of all the significant changes, organized by category, not by update or beta release.

  • Improvements to Output Formatting, Error Reports and JSON Support
    • Intel(R) Cluster Checker has greatly improved its output formatting and error reporting. These changes have been introduced over the past year in the Update packages, and during the beta release for oneAPI.  Intel(R) Cluster Checker has adopted a new summarized report upon completion, with details from the analysis available in the clck_report.log (or designated -o <filename>), and details about the execution environment for Intel(R) Cluster Checker in the clck_execution_warnings.log file.
  • New Support for OSU and Intel(R) MPI workloads and analysis
    • Intel(R) Cluster Checker now provides a wide array of workloads and test suites available for the evaluation and continued performance analysis of the compute environment. Support is now extended to the execution of Ohio State University (OSU) workloads. While the specific OSU workloads are not provided as part of the standard Intel(R) Cluster Checker installation, the OSU workloads can be installed separately and used by Intel(R) Cluster Checker for the evaluation and analysis of the environment. Many of the OSU workloads support the MPICH messaging protocols.
  • New and modified framework definitions
    • Several new framework definitions have been added to Intel(R) Cluster Checker to aid in the validation and analysis of clustered environments. While others have been cleaned up or modified to enable a cleaner and better understanding of the frameworks. These new and modified framework definitions include the following:
      • health_base
      • health_user
      • health_exteded_user
      • health_admin
      • health_extended_admin
      • osu_*
    • To get a full listing of the available framework definitions execute the following on the command line: 'clck -X list'
    • For details about a specific framework definiton either refer to the reference section of the User's Guide or perform the following on the command line: 'clck -X <framework definition name>'
      • example: 'clck -X health_base'
  • New Feature for Node Group Analysis and Reporting
    • Intel(R) Cluster Checker has introduced the ability to analyze discrete groups of compute nodes. The new feature utilizes a command line option, -g, and an xml file designating the grouping of the compute nodes. The grouping could be based upon physical characteristics of the nodes, location, or other featuers. A compute node can belong in multiple node groups at the same time. The new feature only applies to the analysis of the nodes. Collection of the data for the specific framework definitions is across al designated nodes. Please see the User's Guide for more details on implementing this feature, the xml file setup and example, and interpretation of the analysis results.
  • Support for Linux Environment Modules
    • Intel(R) Cluster Checker now supports the use of Linux environment modules for setting up the proper runtime environment. The environment modules support provide an alternative to the current setup requirements found in the clckvars.[sh|csh] script. Please see the User's Guide for addtional details and setup requirements.
  • Improved Support for ksh and zsh shells
    • Intel(R) Cluster Checker has expanded the number of shell environments that can be utilized for the collection and analysis of clustered systems by supporting ksh (korn shell) and zsh (z-shell). Specific details, setup, and exemptions are included in the User's Guide for Intel(R) Cluster Checker.
  • Propagation of Environment Variables
    • Intel(R) Cluster Checker has now added environment variable propagation with its default pdsh-based remote execution on compute nodes. This enables proper operation of of data collection on compute nodes within consistent environment settings.
    • A new command line option '-e' was added to turn off the environment variable propagation for backward compatibility.
  • Changes to Default Temporary File Permissions
    • Intel(R) Cluster Checker has modified its default temporary file permissions to remove the "world-writable" flag on all files and the temporary directory used by Intel(R) Cluster Checker to store temporary files before analysis. This change is to provide better security to users and ensure only those authorized to access Intel(R) Cluster Checker results are allowed to do so. Intel(R) Cluster Checker still allows users and groups authorized to execute the tools to read and write files, but limits access by others.
  • Update to checks on $TMPDIR
    • Intel(R) Cluster Checker has modified the check for file permissions to not require any 'world' permissions for $TMPDIR.
  • Updates of 3rd Party Components to Correct CVEs
    • Intel(R) Cluster Checker leverages several third-party components to assist in the collection, analysis and generation of reports. To maintain security commitments to Intel(R) and our customers, Intel(R) Cluster Checker is reguarly scanned using industry standard tools for exposure of Common Vunerable Exploits in the third-party components. It is important for customers using Intel(R) Cluster Checker to maintain their implementations at the latest level to not only receive the latest improvements to the collection and analysis, but also to receive the most recent updates to these third-party components.



Linux* Release Notes

  • Added feature to propagate all user environment variables to all nodes when using pdsh for remote execution, with the exception of the following system variables: $HOSTNAME, $HOST, $HOSTTYPE, $MACHTYPE, $OSTYPE,  $PMI_RANK, $PMI_SIZE, $PMI_FD, $MPI_LOCALRANKID, $MPI_LOCALNRANKS, $DISPLAY, $SHLVL, $_, $BASH_FUNC. This is the default setting.
    • To suppress propagation of any environment variables to any nodes when using pdsh add command line option ‘-e’ or 'export CLCK_TURN_OFF_ENV_PROPAGATION=true'
    • the framework definition 'environment_variables_uniformity' can be used to inspect a list of all environment variables found on all nodes. (clckdb -D <path>/clck.db –provider printenv)
  • Correct paths for the Intel® MPI Benchmarks providers to locate IMB binaries and removed imb_wrapper in imb_pingpong as it was not being used.
  • Modifications to the messages provided when *-data-missing is reported by the analyzer. This is to improve the recommended remedies.
  • Fix to correctly check for Intel Python 3, dropping check for Intel Python 2 with Intel® Parallel Studio XE 2020 runtimes or later.
  • Fix for false positive signs from clck-analyzer about missing libraries for offload. These libraries are no longer required.
  • Fix to execution of the data collection for the framework definition "mpi_local_functionality".
  • Fix to standalone execution of framework definition "infiniband_admin"
  • Extended node groups feature to work on relative framework definition paths
  • Improvements to several messages provided on 'data-is-too-old' or '*-data-missing-remedy' as reported by the analyzer.
  • Corrected online documentation for hpcg_cluster framework definition.
  • Improvement to the data collection of the "df" data provider.
  • Added environment support for zsh and ksh in script.
  • Update SQLite to version 3.32.3 to fix:
    • CVE-2020-15358
  • Update libxml2 to fix:
    • CVE-2020-24977
  • Update zeromq to version 4.3.3 to fix:
    • CVE-2020-15166






Notices and Disclaimers

Intel technologies may require enabled hardware, software or service activation.

No product or component can be absolutely secure.

Your costs and results may vary.

© Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.

No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.

The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.

Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at