Data Providers

Intel® Cluster Checker uses environment variables to configure data providers. The namespace CLCK_PROVIDER_PROVIDER-NAME is reserved for each provider, where the PROVIDER-NAME is the name of the corresponding provider. Each provider can define its own variables within its namespace, and each provider is responsible for reading its own environment variables. While these variables can be set in the user's shell initialization files (such as .bashrc), the recommended method is to define these variables in the providers configuration file. An example providers configuration file is located at /opt/intel/clck/201n/etc/providers/select_solutions_sim_mod.xml. The providers configuration file must be included in the framework definition using the following syntax:

<configuration>
    <framework_definition name="myFWD">
        <providers config_file="select_solutions_sim_mod.xml">
            <provider>dgemm</provider>
        </providers>
    </framework_definition>
</configuration>

The XML configuration file hides the raw environment variable names. Instead, the environment variable gets constructed by combining the XML tag names. For example, the following construct will generate the environment variable CLCK_PROVIDER_HPL_CLUSTER_FABRICS, which would then be made available to the HPL_CLUSTER provider.

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <fabrics>value</fabrics>
         </hpl_cluster>
      </provider>
      ...
   </collector>

Note that the value is enclosed within double quotes when passed to the provider. Consequently, if the value provided in the XML file contains double quotes, it will be ignored and the environment variable will not be constructed.

XML configuration files can also be used to enable running the same provider multiple times with disjoint sets of configuration options. For example, the following XML configuration would run the HPL_CLUSTER twice, once with CLCK_PROVIDER_HPL_CLUSTER_FABRICS= shm:tcp and once with CLCK_PROVIDER_HPL_CLUSTER_FABRICS= shm:ofi.

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <optionset id="1">
               <fabrics>shm:tcp</fabrics>
            </optionset>
            <optionset id="2">
               <fabrics>shm:ofi</fabrics>
            </optionset>
         </hpl_cluster>
      </provider>
      ...
   </collector>

The id attribute is required. For each run, the value of the corresponding id attribute will be stored in the database under the OptionID column. The value of this attribute is purely arbitrary and not meaningful other than to distinguish one set of options from another in the output columns of the database. However, the value must not contain tabs, newlines, parentheses, ampersands, vertical bars, the greater-than symbol <, the tilde symbol ~, spaces, semicolons, or double quotes. If no optionset tags are specified, the OptionID column will contain the string default. Additionally, if any tags are specified outside of optionset tags, the corresponding environment variables will be made available for every single optionset specified.

By default, providers timeout after 60 seconds (constant time). It is possible to specify the timeout value for any provider in the providers config file. The default scale is constant, and accepted scale values are linear, constant, and logarithmic. To specify a timeout (in seconds) for a provider in the providers config file, use the following syntax:

<hpcg_cluster>
    <timeout scale="linear">700</timeout>
</hpcg_cluster>

To specify a timeout value for a specific optionset, use the following syntax:

<hpcg_cluster>
    <optionset id="1">
        <timeout scale="linear">70</timeout>
    </optionset>
</hpcg_cluster>

A timeout specified in an individual optionset supersedes a timeout specified for the provider generally. If the computed timeout is less than 60 seconds, it will default to 60 seconds.

This chapter lists configuration options available for each provider.

cpuid

CLCK_PROVIDER_CPUID_BINARY

 

Configure the location of the cpuid binary.

Environmental variable syntax: CLCK_PROVIDER_CPUID_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <cpuid>
            <binary>value</binary>
         </cpuid>
      </provider>
      ...
   </collection>

 

Default is the same path as that detected using the which command.

 

dgemm

CLCK_PROVIDER_DGEMM_KMP_AFFINITY

 

Configure thread affinity for dgemm.

Environmental variable syntax: CLCK_PROVIDER_DGEMM_KMP_AFFINITY=value

  • where value is the KMP_AFFINITY setting.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <kmp_affinity>value</kmp_affinity>
         </dgemm>
      </provider>
      ...
   </collector>

 

If not set, default is chosen based on the processor.

 

CLCK_PROVIDER_DGEMM_KMP_HW_SUBSET

 

Configure hardware set (for dgemm only) for Intel® Xeon Phi™ processors (not coprocessors).

Environmental variable syntax: CLCK_PROVIDER_DGEMM_KMP_HW_SUBSET=value

  • where value is the KMP_HW_SUBSET setting.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <kmp_hw_subset>value</kmp_hw_subset>
         </dgemm>
      </provider>
      ...
   </collector>

 

Default value is set depending on the processor.

 

CLCK_PROVIDER_DGEMM_ITERATIONS

 

Configure the number of iterations performed by the dgemm routine.

Environmental variable syntax: CLCK_PROVIDER_DGEMM_ITERATIONS=value

  • where value is the number of iterations.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <iterations>value</iterations>
         </dgemm>
      </provider>
      ...
   </collector>

 

Default value is 9.

 

CLCK_PROVIDER_DGEMM_{M,N,K}_PARAMETER

 

Configure the value of m, n and k passed to the dgemm routine.

Environmental variable syntax:

  • CLCK_PROVIDER_DGEMM_M_PARAMETER=value

  • CLCK_PROVIDER_DGEMM_N_PARAMETER=value

  • CLCK_PROVIDER_DGEMM_K_PARAMETER=value

  • where value is the m, n and k setting, respectively.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <m_parameter>value</m_parameter>
            <n_parameter>value</n_parameter>
            <k_parameter>value</k_parameter>
         </dgemm>
      </provider>
      ...
   </collector>

 

All three parameters must be set to be used. When these variable are not set, default values are set depending on the processor and possibly the memory size. For alternative way to configure these parameters, please refer to memory usage parameter.

 

CLCK_PROVIDER_DGEMM_{MEMORY_USAGE,K_PARAMETER}

 

Compute the value of m, n and k passed to the dgemm routine based on the configured memory usage and k value.

Environmental variable syntax:

  • CLCK_PROVIDER_DGEMM_MEMORY_USAGE=value

  • CLCK_PROVIDER_DGEMM_K_PARAMETER=value

  • where value is the memory usage and k setting, respectively.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <memory_usage>value</memory_usage>
            <k_parameter>value</k_parameter>
         </dgemm>
      </provider>
      ...
   </collector>

 

The configuration of k is optional and, if not configured, will use a default value. The values of m, n are computed based on the configured memory usage and k. The default value for memory usage is 20% of the total available physical memory. The memory usage parameter can only take integer arguments and can range from 1 to 95. The k parameter takes integers greater than 0. The memory usage parameter is not applicable for Intel® Xeon Phi™ processors, because default set of m, n and k parameters will be used. Setting a valid memory usage parameter will override m and n parameters.

 

CLCK_PROVIDER_DGEMM_TASKSET_BINARY

 

Configure the location of the taskset binary for dgemm.

Environmental variable syntax: CLCK_PROVIDER_DGEMM_TASKSET_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <tasket_binary>value</taskset_binary>
         </dgemm>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

CLCK_PROVIDER_DGEMM_TASKSET

 

Configure the list of cores to be used with taskset (for dgemm only) for Intel® Xeon Phi™ processors (not coprocessors) (-c option).

Environmental variable syntax: CLCK_PROVIDER_DGEMM_TASKSET=value

  • where value is the list of cores, for example, 2-32.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dgemm>
            <taskset>value</taskset>
         </dgemm>
      </provider>
      ...
   </collector>

 

Default value is set depending on the processor (use all available cores).

 

dmesg

CLCK_PROVIDER_DMESG_BINARY

 

Configure the location of the dmesg binary.

Environmental variable syntax: CLCK_PROVIDER_DMESG_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <dmesg>
            <binary>value</binary>
         </dmesg>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

dmidecode

CLCK_PROVIDER_DMIDECODE_PATH

 

Configure the location of dmidecode.

Environmental variable syntax: CLCK_PROVIDER_DMIDECODE_PATH=value

  • where value is the path to dmidecode.

 

XML Syntax:

   <collector>
      ...
      <provider>
         <dmidecode>
            <path>value</path>
         </dmidecode>
      </provider>
      ...
   </collector>

 

hpcg_cluster

CLCK_PROVIDER_HPCG_CLUSTER_OPTIONS

 

Options to be passed into Intel® MPI Library.

Environmental variable syntax: CLCK_PROVIDER_HPCG_CLUSTER_OPTIONS=value

  • where value is the option.

 

XML Syntax:

   <collector>
      ...
      <provider>
         <hpcg_cluster>
            <options>-genv OPTION_NAME=value</options>
         </hpcg_cluster>
      </provider>
      ...
   </collector>
 

 

hpl_cluster

CLCK_PROVIDER_HPL_CLUSTER_FABRICS

 

Configure the network fabric.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_FABRICS=value

  • where value directly maps to the I_MPI_FABRICS Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <fabrics>value</fabrics>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate fabric.

 

CLCK_PROVIDER_HPL_CLUSTER_DAPL_PROVIDER

 

Configure the DAPL provider.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_DAPL_PROVIDER=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <dapl_provider>value</dapl_provider>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL provider.

 

CLCK_PROVIDER_HPL_CLUSTER_DAPL_PROVIDER_LIST

 

Configure the DAPL providers to load.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_DAPL_PROVIDER_LIST=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER_LIST Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <dapl_provider_list>value</dapl_provider_list>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL providers.

 

CLCK_PROVIDER_HPL_CLUSTER_MPI_PIN

 

Configure MPI pinning to on or off.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_MPI_PIN=value

  • where value directly maps to the I_MPI_PIN Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <mpi_pin>value</mpi_pin>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

If MPI is failing on Intel® Xeon Phi™ processors while the isolcpus kernel parameter is on, try to change or remove the isolcpus kernel parameter. If this is not possible, try turning off process pinning.

When this variable is not set, it defaults to on.

 

CLCK_PROVIDER_HPL_CLUSTER_OFA_ADAPTER_NAME

 

Configure the OpenFabrics Alliance* (OFA) adapter name.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_OFA_ADAPTER_NAME=value

  • where value directly maps to the I_MPI_OFA_ADAPTER_NAME Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <ofa_adapter_name>value</ofa_adapter_name>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFA adapter name.

 

CLCK_PROVIDER_HPL_CLUSTER_OFI_PROVIDER

 

Configure the OFI provider.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_OFI_PROVIDER=value

  • where value directly maps to the I_MPI_OFI_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <ofi_provider>value</ofi_provider>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFI provider.

 

CLCK_PROVIDER_HPL_CLUSTER_OPTIONS

 

Options to be passed into Intel® MPI Library.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_OPTIONS=value

  • where value is the option.

 

XML Syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <options>-genv OPTION_NAME=value</options>
         </hpl_cluster>
      </provider>
      ...
   </collector>
 

 

CLCK_PROVIDER_HPL_CLUSTER_PERCENT_MEMORY

 

Configure the memory size.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_PERCENT_MEMORY=value

  • where value is a percentage of the total cluster memory to be used in the HPL calculation.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <percent_memory>value</percent_memory>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

The value should be between 1 and 80. Larger values will experience longer run times but will result in higher benchmark performance.

When this variable is not set, the default value of 2 is set.

 

CLCK_PROVIDER_HPL_CLUSTER_PPN

 

Configure the number of MPI processes to start per node.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_PPN=value

where value is:

  • core

    • Start one MPI process per physical core.

     

  • a number

    • The number of MPI processes to start per node.

     

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <ppn>value</ppn>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

This configuration parameter is not recognized for nodes with Intel® Xeon Phi™ coprocessors.

When this variable is not set, one MPI process per node is used.

 

CLCK_PROVIDER_HPL_CLUSTER_TCP_NETMASK

 

Configure the TCP netmask.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_TCP_NETMASK=value

  • where value directly maps to the I_MPI_TCP_NETMASK Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <tcp_netmask>value</tcp_netmask>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TCP netmask value.

 

CLCK_PROVIDER_HPL_CLUSTER_TMI_PROVIDER

 

Configure the TMI provider.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_TMI_PROVIDER=value

  • where value directly maps to the I_MPI_TMI_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <tmi_provider>value</tmi_provider>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TMI provider.

 

CLCK_PROVIDER_HPL_CLUSTER_OPTIONS

 

Configure additional options.

Environmental variable syntax: CLCK_PROVIDER_HPL_CLUSTER_OPTIONS=value

  • where value is any option passed as is to the mpirun command.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_cluster>
            <options>value</options>
         </hpl_cluster>
      </provider>
      ...
   </collector>

 

 

hpl_pairwise

CLCK_PROVIDER_HPL_PAIRWISE_FABRICS

 

Configure the network fabric.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_FABRICS=value

  • where value directly maps to the I_MPI_FABRICS Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <fabrics>value</fabrics>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate fabric.

 

CLCK_PROVIDER_HPL_PAIRWISE_DAPL_PROVIDER

 

Configure the DAPL provider.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_DAPL_PROVIDER=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <dapl_provider>value</dapl_provider>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL provider.

 

CLCK_PROVIDER_HPL_PAIRWISE_DAPL_PROVIDER_LIST

 

Configure the DAPL providers to load.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_DAPL_PROVIDER_LIST=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER_LIST Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <dapl_provider_list>value</dapl_provider_list>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL providers.

 

CLCK_PROVIDER_HPL_PAIRWISE_MPI_PIN

 

Configure MPI pinning to on or off

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_MPI_PIN=value

  • where value directly maps to the I_MPI_PIN Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <mpi_pin>value</mpi_pin>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

If MPI is failing on Intel® Xeon Phi™ processors while the isolcpus kernel parameter is on, try to change or remove the isolcpus kernel parameter. If this is not possible, try turning off process pinning.

When this variable is not set, it defaults to on.

 

CLCK_PROVIDER_HPL_PAIRWISE_OFA_ADAPTER_NAME

 

Configure the OFA adapter.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_OFA_ADAPTER_NAME=value

  • where value directly maps to the I_MPI_OFA_ADAPTER_NAME Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <ofa_adapter_name>value</ofa_adapter_name>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFA adapter name.

 

CLCK_PROVIDER_HPL_PAIRWISE_OFI_PROVIDER

 

 
   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <ofi_provider>value</ofi_provider>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFI provider.

 

CLCK_PROVIDER_HPL_PAIRWISE_PERCENT_MEMORY

 

Configure the memory size.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_PERCENT_MEMORY=value

  • where value is a percentage of the total cluster memory to be used in the HPL calculation.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <percent_memory>value</percent_memory>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

The value should be between 1 and 80. Larger values will experience longer run times but will result in higher benchmark performance.

When this variable is not set, the default value of 5 is set.

 

CLCK_PROVIDER_HPL_PAIRWISE_PPN

 

Configure the number of MPI processes to start per node.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_PPN=value

where value is:

  • core

    • Start one MPI process per physical core.

     

  • a number

    • The number of MPI processes to start per node.

     

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <ppn>value</ppn>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

This configuration parameter is not recognized for nodes with Intel® Xeon Phi™ coprocessors.

When this variable is not set, one MPI process per node is used.

 

CLCK_PROVIDER_HPL_PAIRWISE_TCP_NETMASK

 

Configure the TCP netmask.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_TCP_NETMASK=value

  • where value directly maps to the I_MPI_TCP_NETMASK Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <tcp_netmask>value</tcp_netmask>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TCP netmask value.

 

CLCK_PROVIDER_HPL_PAIRWISE_TMI_PROVIDER

 

Configure the TMI provider.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_TMI_PROVIDER=value

  • where value directly maps to the I_MPI_TMI_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <tmi_provider>value</tmi_provider>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TMI provider.

 

CLCK_PROVIDER_HPL_PAIRWISE_OPTIONS

 

Configure additional options.

Environmental variable syntax: CLCK_PROVIDER_HPL_PAIRWISE_OPTIONS=value

  • where value is any option passed as is to the mpirun command.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hpl_pairwise>
            <options>value</options>
         </hpl_pairwise>
      </provider>
      ...
   </collector>

 

 

hwloc_dump_hwdata

CLCK_PROVIDER_HWLOC_DUMP_HWDATA_HWLOC_FILE

 

Configure the location of the hwloc-dump-hwdata output file.

Environmental variable syntax: CLCK_PROVIDER_HWLOC_DUMP_HWDATA_HWLOC_FILE=value

  • where value is the path to the file.

 

XML syntax:

   <collector>
      ...
      <provider>
         <hwloc_dump_hwdata>
            <hwloc_file>value</hwloc_file>
         </hwloc_dump_hwdata>
      </provider>
      ...
   </collector>

 

The default location is /var/run/hwloc/knl_memoryside_cache.

 

ibstat

CLCK_PROVIDER_IBSTAT_BINARY

 

Configure the location of the ibstat binary.

Environmental variable syntax: CLCK_PROVIDER_IBSTAT_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <ibstat>
            <binary>value</binary>
         </ibstat>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

ibv_devinfo

CLCK_PROVIDER_IBV_DEVINFO_BINARY

 

Configure the location of the ibv_devinfo binary.

Environmental variable syntax: CLCK_PROVIDER_IBV_DEVINFO_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <ibv_devinfo>
            <binary>value</binary>
         </ibv_devinfo>
      </provider>
      ...
   </collector>

 

When this variable is not set, /usr/bin/ibv_devinfo is used.

 

imb_pingpong

CLCK_PROVIDER_IMB_PINGPONG_FABRICS

 

Configure the network fabric.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_FABRICS=value

  • where value directly maps to the I_MPI_FABRICS Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <fabrics>value</fabrics>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate fabric.

 

CLCK_PROVIDER_IMB_PINGPONG_DAPL_PROVIDER

 

Configure the DAPL provider.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_DAPL_PROVIDER=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <dapl_provider>value</dapl_provider>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL provider.

 

CLCK_PROVIDER_IMB_PINGPONG_DAPL_PROVIDER_LIST

 

Configure the DAPL providers to load.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_DAPL_PROVIDER_LIST=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER_LIST Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <dapl_provider_list>value</dapl_provider_list>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL providers.

 

CLCK_PROVIDER_IMB_PINGPONG_MPI_PIN

 

Configure MPI pinning to on or off.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_MPI_PIN=value

  • where value directly maps to the I_MPI_PIN Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <mpi_pin>value</mpi_pin>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

If MPI is failing on Intel® Xeon Phi™ processors while the isolcpus kernel parameter is on, try to change or remove the isolcpus kernel parameter. If this is not possible, try turning off process pinning.

When this variable is not set, it defaults to on.

 

CLCK_PROVIDER_IMB_PINGPONG_OFA_ADAPTER_NAME

 

Configure the OFA adapter name.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_OFA_ADAPTER_NAME=value

  • where value directly maps to the I_MPI_OFA_ADAPTER_NAME Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <ofa_adapter_name>value</ofa_adapter_name>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFA adapter name.

 

CLCK_PROVIDER_IMB_PINGPONG_OFI_PROVIDER

 

Configure the OFI provider.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_OFI_PROVIDER=value

  • where value directly maps to the I_MPI_OFI_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <ofi_provider>value</ofi_provider>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFI provider.

 

CLCK_PROVIDER_IMB_PINGPONG_TCP_NETMASK

 

Configure the TCP netmask.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_TCP_NETMASK=value

  • where value directly maps to the I_MPI_TCP_NETMASK Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <tcp_netmask>value</tcp_netmask>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TCP netmask value.

 

CLCK_PROVIDER_IMB_PINGPONG_TMI_PROVIDER

 

Configure the TMI provider.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_TMI_PROVIDER=value

  • where value directly maps to the I_MPI_TMI_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <tmi_provider>value</tmi_provider>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TMI provider.

 

CLCK_PROVIDER_IMB_PINGPONG_OPTIONS

 

Configure additional options.

Environmental variable syntax: CLCK_PROVIDER_IMB_PINGPONG_OPTIONS=value

  • where value is any option passed verbatim to the mpirun command.

 

XML syntax:

   <collector>
      ...
      <provider>
         <imb_pingpong>
            <options>value</options>
         </imb_pingpong>
      </provider>
      ...
   </collector>

 

 

iozone

CLCK_PROVIDER_IOZONE_FILESIZE

 

Configure the size of the temporary file used by the benchmark.

Environmental variable syntax: CLCK_PROVIDER_IOZONE_FILESIZE=value

  • where value is file size in Kbytes

 

XML syntax:

   <collector>
      ...
      <provider>
         <iozone>
            <filesize>value</filesize>
         </iozone>
      </provider>
      ...
   </collector>

 

When this variable is not set, 65536 is used.

 

CLCK_PROVIDER_IOZONE_RECSIZE

 

Configure the record size used by the benchmark.

Environmental variable syntax: CLCK_PROVIDER_IOZONE_RECSIZE=value

  • where value is record size in Kbytes.

 

XML syntax:

   <collector>
      ...
      <provider>
         <iozone>
            <recsize>value</recsize>
         </iozone>
      </provider>
      ...
   </collector>

 

When this variable is not set, 16384 is used.

 

CLCK_PROVIDER_IOZONE_WORKDIR

 

Configure the location of the temporary file created by the benchmark.

Environmental variable syntax: CLCK_PROVIDER_IOZONE_WORKDIR=value

  • where value is a directory.

 

XML syntax:

   <collector>
      ...
      <provider>
         <iozone>
            <workdir>value</workdir>
         </iozone>
      </provider>
      ...
   </collector>

 

Recommendation: Set this value to local file system.

When this variable is not set, /tmp is used.

 

lscpu

CLCK_PROVIDER_LSCPU_BINARY

 

Configure the location of the lscpu binary.

Environmental variable syntax: CLCK_PROVIDER_LSCPU_BINARY=value

  • where value is the path to the binary,

 

XML syntax:

   <collector>
      ...
      <provider>
         <lscpu>
            <binary>value</binary>
         </lscpu>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

lscpi

CLCK_PROVIDER_LSPCI_BINARY

 

Configure the location of the lspci binary.

Environmental variable syntax: CLCK_PROVIDER_LSPCI_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <lspci>
            <binary>value</binary>
         </lspci>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

lustre

CLCK_PROVIDER_LUSTRE_STRIPE_BINARY

 

Configure the location of the Lustre* utility binary.

Environmental variable syntax: CLCK_PROVIDER_LUSTRE_STRIPE_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <lustre_stripe>
            <binary>value</binary>
         </lustre_stripe>
      </provider>
      ...
   </collector>

 

When this variable is not set, /usr/bin/lfs is used.

 

mpi_internode

CLCK_PROVIDER_MPI_INTERNODE_FABRICS

 

Configure the network fabric.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_FABRICS=value

  • where value directly maps to the I_MPI_FABRICS Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <fabrics>value</fabrics>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate fabric.

 

CLCK_PROVIDER_MPI_INTERNODE_DAPL_PROVIDER

 

Configure the DAPL provider.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_DAPL_PROVIDER=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <dapl_provider>value</dapl_provider>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL provider.

 

CLCK_PROVIDER_MPI_INTERNODE_DAPL_PROVIDER_LIST

 

Configure the DAPL providers to load.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_DAPL_PROVIDER_LIST=value

  • where value directly maps to the I_MPI_DAPL_PROVIDER_LIST Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <dapl_provider_list>value</dapl_provider_list>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate DAPL providers.

 

CLCK_PROVIDER_MPI_INTERNODE_MPI_PIN

 

Configure MPI pinning to on or off.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_MPI_PIN=value

  • where value directly maps to the I_IMP_PIN Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <mpi_pin>value</mpi_pin>
         <mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

If MPI is failing on Intel® Xeon Phi™ processors while the isolcpus kernel parameter is on, try to change or remove the isolcpus kernel parameter. If this is not possible, try turning off process pinning.

When this variable is not set, it defaults to on.

 

CLCK_PROVIDER_MPI_INTERNODE_OFA_ADAPTER_NAME

 

Configure the OFA adapter name.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_OFA_ADAPTER_NAME=value

  • where value directly maps to the I_MPI_OFA_ADAPTER_NAME Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <ofa_adapter_name>value</ofa_adapter_name>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate OFA adapter name.

 

CLCK_PROVIDER_MPI_INTERNODE_TCP_NETMASK

 

Configure the TCP netmask.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_TCP_NETMASK=value

  • where value directly maps to the I_MPI_TCP_NETMASK Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <tcp_netmask>value</tcp_netmask>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TCP netmask value.

 

CLCK_PROVIDER_MPI_INTERNODE_TMI_PROVIDER

 

Configure the TMI provider.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_TMI_PROVIDER=value

  • where value directly maps to the I_MPI_TMI_PROVIDER Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <tmi_provider>value</tmi_provider>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

When this variable is not set, Intel® MPI Library automatically chooses the most appropriate TMI provider.

 

CLCK_PROVIDER_MPI_INTERNODE_OPTIONS

 

Configure additional options.

Environmental variable syntax: CLCK_PROVIDER_MPI_INTERNODE_OPTIONS=value

  • where value is any option passed as is to the mpirun command.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_internode>
            <options>value</options>
         </mpi_internode>
      </provider>
      ...
   </collector>

 

 

mpi_local

CLCK_PROVIDER_MPI_LOCAL_MPI_PIN

 

Configure MPI pinning to on or off.

Environmental variable syntax: CLCK_PROVIDER_MPI_LOCAL_MPI_PIN=value

  • where value directly maps to the I_MPI_PIN Intel® MPI Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <mpi_local>
            <mpi_pin>value</mpi_pin>
         <mpi_local>
      </provider>
      ...
   </collector>

 

Refer to the Intel® MPI Library Reference Manual for more information and recognized values.

If MPI is failing on Intel® Xeon Phi™ processors while the isolcpus kernel parameter is on, try to change or remove the isolcpus kernel parameter. If this is not possible, try turning off process pinning.

When this variable is not set, it defaults to on.

 

numactl

CLCK_PROVIDER_NUMACTL_BINARY

 

Configure the location of the numactl binary.

Environmental variable syntax: CLCK_PROVIDER_NUMACTL_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <numactl>
            <binary>value</binary>
         </numactl>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

ofedinfo

CLCK_PROVIDER_OFEDINFO_BINARY

 

Configure the location of the ofedinfo binary.

Environmental variable syntax: CLCK_PROVIDER_OFEDINFO_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <ofedinfo>
            <binary>value</binary>
         </ofedinfo>
      </provider>
      ...
   </collector>

 

When this variable is not set, /usr/bin/ofed_info is used.

 

opahfirev

CLCK_PROVIDER_OPAHFIREV_PATH

 

Configure the location of opahfirev (which should be the same as the location referenced in opatools).

Environmental variable syntax: CLCK_PROVIDER_OPAHFIREV_PATH=value

  • where value is the path to opahfirev.

 

XML syntax:

   <collector>
      ...
      <provider>
         <opahfirev>
            <path>value</path>
         </opahfirev>
      </provider>
      ...
   </collector>

 

When this variable is not set, the PATH environment variable is used.

 

opasmaquery

CLCK_PROVIDER_OPASMAQUERY_PATH

 

Configure the location of opasmaquery (which should be the same as the location referenced in opatools).

Environmental variable syntax: CLCK_PROVIDER_OPASMAQUERY_PATH=value

  • where value is the path to opasmaquery.

 

XML syntax:

   <collector>
      ...
      <provider>
         <opasmaquery>
            <path>value</path>
         </opasmaquery>
      </provider>
      ...
   </collector>

 

When this variable is not set, the PATH environment variable is used.

 

opatools

CLCK_PROVIDER_OPATOOLS_PATH

 

Configure the location of Intel® Omni-Path Fabric Suite FastFabric tools - and should be same as that set for other Intel® Omni-Path Host Fabric Interface providers (opahfirev and opasmaquery).

Environmental variable syntax: CLCK_PROVIDER_OPATOOLS_PATH=value

  • where value is the path to the tools.

 

XML syntax:

   <collector>
      ...
      <provider>
         <opatools>
            <path>value</path>
         </opatools>
      </provider>
      ...
   </collector>

 

When this variable is not set, the PATH environment variable is used.

 

saquery

 

Configure the location of saquery.

Environmental variable syntax: CLCK_PROVIDER_SAQUERY_PATH=value

  • where value is the path to saquery.

 

XML Syntax:

   <collector>
      ...
      <provider>
         <saquery>
            <path>value</path>
         </saquery>
      </provider>
      ...
   </collector>

 

stat_home

CLCK_PROVIDER_STAT_HOME_PATH

 

Configure the location of the shared users home directory.

Environmental variable syntax: CLCK_PROVIDER_STAT_HOME_PATH=value

  • where value is the path to the directory.

 

XML syntax:

   <collector>
      ...
      <provider>
         <stat_home>
            <path>value</path>
         </stat_home>
      </provider>
      ...
   </collector>

 

When this variable is not set, $HOME is used.

 

sgemm

CLCK_PROVIDER_SGEMM_FAST_MEMORY_LIMIT

 

Configure the high bandwidth memory limit for sgemm on Intel® Xeon Phi™ processors (not coprocessors).

Environmental variable syntax: CLCK_PROVIDER_SGEMM_FAST_MEMORY_LIMIT=value

  • where value directly maps to the MKL_FAST_MEMORY_LIMIT Intel® Math Kernel Library environment variable.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <fast_memory_limit>value</fast_memory_limit>
         </sgemm>
      </provider>
      ...
   </collector>

 

If not set, default is set to 0. This configuration parameter is only applicable in case of Intel(R).

CLCK_PROVIDER_SGEMM_KMP_AFFINITY

 

Configure thread affinity for sgemm.

Environmental variable syntax: CLCK_PROVIDER_SGEMM_KMP_AFFINITY=value

  • where value is the KMP_AFFINITY setting.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <kmp_affinity>value</kmp_affinity>
         </sgemm>
      </provider>
      ...
   </collector>

 

If not set, default is chosen based on the processor.

 

CLCK_PROVIDER_SGEMM_KMP_HW_SUBSET

 

Configure hardware set (for sgemm only) for Intel® Xeon Phi™ processors (not coprocessors).

Environmental variable syntax: CLCK_PROVIDER_SGEMM_KMP_HW_SUBSET=value

  • where value is the KMP_HW_SUBSET setting.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <kmp_hw_subset>value</kmp_hw_subset>
         </sgemm>
      </provider>
      ...
   </collector>

 

Default value is set depending on the processor.

 

CLCK_PROVIDER_SGEMM_ITERATIONS

 

Configure the number of iterations performed by the sgemm routine.

Environmental variable syntax: CLCK_PROVIDER_SGEMM_ITERATIONS=value

  • where value is the number of iterations.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <iterations>value</iterations>
         </sgemm>
      </provider>
      ...
   </collector>

 

Default value is 5.

 

CLCK_PROVIDER_SGEMM_{M,N,K}_PARAMETER

 

Configure the value of m, n and k passed to the dgemm routine.

Environmental variable syntax:

  • CLCK_PROVIDER_SGEMM_M_PARAMETER=value

  • CLCK_PROVIDER_SGEMM_N_PARAMETER=value

  • CLCK_PROVIDER_SGEMM_K_PARAMETER=value

  • where value is the m, n and k setting, respectively.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <m_parameter>value</m_parameter>
            <n_parameter>value</n_parameter>
            <k_parameter>value</k_parameter>
         </sgemm>
      </provider>
      ...
   </collector>

 

All three parameters must be set to be used. When these variable are not set, default values are set depending on the processor and possibly the memory size. For alternative way to configure these parameters, please refer to memory usage parameter.

 

CLCK_PROVIDER_SGEMM_{MEMORY_USAGE,K_PARAMETER}

 

Compute the value of m, n and k passed to the sgemm routine based on the configured memory usage and k value.

Environmental variable syntax:

  • CLCK_PROVIDER_SGEMM_MEMORY_USAGE=value

  • CLCK_PROVIDER_SGEMM_N_PARAMETER=value

  • where value is the memory usage and k setting, respectively.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <memory_usage>value</memory_usage>
            <k_parameter>value</k_parameter>
         </sgemm>
      </provider>
      ...
   </collector>

 

The configuration of k is optional and, if not configured, will use a default value. The values of m, n are computed based on the configured memory usage and k. The default value for memory usage is 20% of the total available physical memory. The memory usage parameter can only take integer arguments and can range from 1 to 95. The k parameter takes integers greater than 0. The memory usage parameter is not applicable for Intel® Xeon Phi™ processors, because default set of m, n and k parameters will be used. Setting a valid memory usage parameter will override m and n parameters.

 

CLCK_PROVIDER_SGEMM_TASKSET

 

Configure the list of cores to be used with taskset (for sgemm only) (-c option).

Environmental variable syntax: CLCK_PROVIDER_SGEMM_TASKSET=value

  • where value is the list of cores, for example, 2-32.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <taskset>value</taskset>
         </sgemm>
      </provider>
      ...
   </collector>

 

Default value is set depending on the processor (use all available cores).

 

CLCK_PROVIDER_SGEMM_TASKSET_BINARY

 

Configure the location of the taskset binary for sgemm.

Environmental variable syntax: CLCK_PROVIDER_SGEMM_TASKSET_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <tasket_binary>value</taskset_binary>
         </sgemm>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

CLCK_PROVIDER_SGEMM_NUMACTL_BINARY

 

Configure the location of the numactl binary for sgemm on Intel® Xeon Phi™ processors (not coprocessors).

Environmental variable syntax: CLCK_PROVIDER_SGEMM_NUMACTL_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <numactl_binary>value</numactl_binary>
         </sgemm>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command. sgemm execution uses -i all numactl options for execution

 

stream

CLCK_PROVIDER_STREAM_TASKSET_BINARY

 

Configure the location of the taskset binary for stream.

Environmental variable syntax: CLCK_PROVIDER_STREAM_TASKSET_BINARY=value

  • where value is the path to the binary.

 

XML syntax:

   <collector>
      ...
      <provider>
         <stream>
            <tasket_binary>value</taskset_binary>
         </stream>
      </provider>
      ...
   </collector>

 

Default is the same path as that detected using the which command.

 

CLCK_PROVIDER_STREAM_TASKSET

 

Configure the list of cores to be used with taskset (-c option).

Environmental variable syntax: CLCK_PROVIDER_STREAM_TASKSET=value

  • where value is the list of cores, for example, 2-32.

 

XML syntax:

   <collector>
      ...
      <provider>
         <sgemm>
            <taskset>value</taskset>
         </sgemm>
      </provider>
      ...
   </collector>

 

Default value is set depending on the processor (use all available cores).

 

CLCK_PROVIDER_STREAM_USE_PHYSICAL_CORES

 

Option to use only physical core(s).

Environmental variable syntax: CLCK_PROVIDER_STREAM_USE_PHYSICAL_CORES=value

  • where value is whether to use physical cores (yes or no).

 

XML syntax:

   <collector>
      ...
      <provider>
         <stream>
            <use_physical_cores>value</use_physical_cores>
         </stream>
      </provider>
      ...
   </collector>

 

CLCK_PROVIDER_STREAM_{USE_AFFINITY,KMP_AFFINITY}

 

Configure thread affinity for stream.

Environmental variable syntax:

  • CLCK_PROVIDER_STREAM_USE_AFFINITY=value
  • CLCK_PROVIDER_STREAM_KMP_AFFINITY=value

Where value is whether to use affinity (yes or no) and the KMP_AFFINITY setting, respectively. For options for KMP_AFFINITY, refer to the Intel® C++ Compiler documentation.

XML syntax:

   <collector>
      ...
      <provider>
         <stream>
            <use_affinity>value</use_affinity>
         </stream>
      </provider>
      ...
   </collector>

 

If the affinity is not specified, it defaults to granularity=fine,compact,1,0.

 

 

tmiconf

CLCK_PROVIDER_TMICONF_CONFIG_FILE

 

Configure the location of the tmi.conf file, which contains the providers used by Intel® MPI Library for tmi.

Environmental variable syntax: CLCK_PROVIDER_TMICONF_CONFIG_FILE=value

  • where value is path to the file.

 

XML syntax:

   <collector>
      ...
      <provider>
         <tmiconf>
            <config_file>value</config_file>
         </tmiconf>
      </provider>
      ...
   </collector>

 

When this variable is not set, /etc/tmi.conf is used