Intel® Cluster Checker version 1.6 Tips and Tricks

This article shows some tips and tricks for Intel® Cluster Checker version 1.6, please check the release summary for more details on the multiple new features and many improvements.

  • The engine supports a centralized approach for network fabric selection inside the global_configuration container in the configuration file. This allows an easier specification of the network fabrics to be used by the different test modules.

The global configuration option with multiple entries is used to define the network fabrics to be used by test modules that exercise Intel® MPI Library. The <network> container is used to hold the different fabrics that should be entered using the <fabric> container. Multiple fabrics can be configured and each one must include the corresponding MPI device (<device>). Optional attributes are available for the user to specify a custom name to the fabric (name=) and its state (enabled=). The default state is enabled.



<fabric name=”IB” enabled=”on”>



<fabric name=”SM-TCP” enabled=”on”>





  • A --report option is available to easily gather information from previous runs.

Instruct cluster-check to look for the latest output logs in the log directory and generate a report with descriptive information about each execution. The value entered represents the number of latest logs that will be examined to generate the output. The files are ordered by date, taking the latest files first. A maximum of five logs are examined. In addition to the latest five logs, all certification logs are checked for a successful execution. Verbosity can be changed using --verbose value , where higher values produce more output

Intel® Cluster Checker - Last Output Report


This cluster was successfully certified at: 2010-07-13 15:36:02.

Log file: /home/user/config-certification-20100703.153650.xml


Log:            /home/user/config-certification-20100703.153650.xml

Execution Type: Certification

Overall Status: Succeeded

Date:           2010-07-13 15:36:02

Version:        1.6

Command Line:   /opt/intel/clck/1.6/cluster-check --certification 1.1


  • The source code for an XML parser is included as reference for developers to process output log files.

An example on how to implement parsing of the log kernel messages is provided in the modules/ file inside the distributed package.

  • Extra Intel® MPI Library options can be set with an XML attribute in the configuration file.

Additional Intel® MPI Library options can be provided by using an 'options' XML attribute for the <device> tag. The options will be reordered as required by MPI, placing global ones first.

For instance, the first example increases the verbosity of the MPI library run-time messages, the second one specifies the TCP network to use, third one enables the multi-rail fabric combination feature using MPI options and the last one shows how to select the tag matching interface (TMI*) transport.

<device options="-genv I_MPI_DEBUG 5">ssm</device>

<device options="-genv I_MPI_TCP_NETMASK ib0">ssm</device>

<device options="-genv I_MPI_OFA_NUM_ADAPTERS 2">shm:ofa</device>

<device options="-genv I_MPI_TMI_LIBRARY /usr/lib/ -genv I_MPI_TMI_CONFIG /etc/tmi.conf -genv I_MPI_TMI_PROVIDER mx”> tmi </device>

See the Intel® MPI Library Reference Manual for more details on MPI device selection and the available configuration options.

For more complete information about compiler optimizations, see our Optimization Notice.