search

intel / mpi-benchmarks

149 stars 63 forks source link

readme

Intel(R) MPI Benchmarks

3-Clause BSD License v2021.8

Contents

Introduction

Intel(R) MPI Benchmarks provides a set of elementary benchmarks that conform to MPI-1, MPI-2, and MPI-3 standard. You can run all of the supported benchmarks, or a subset specified in the command line using one executable file. Use command-line parameters to specify various settings, such as time measurement, message lengths, and selection of communicators. For details, see the Intel(R) MPI Benchmarks User's Guide located at: https://www.intel.com/content/www/us/en/docs/mpi-library/user-guide-benchmarks/2021-2/overview.html

By default, Intel(R) MPI Benchmarks is installed at:

Before using the Intel(R) MPI Benchmarks, please read the license agreements located in the imb/license directory.

Product Directories

After a successful installation of Intel(R) MPI Benchmarks, the following files and folders appear on your system:

+-- \imb            Intel(R) MPI Benchmarks product directory
     |
     +-- \src_c             Product source "C" code and Makefiles.
     |
     +-- \license           Product license files.
     |    |              
     |    +--license.txt    Source code license granted to you.
     |    |                             
     |    +--use-of-trademark-license.txt    License file describing the 
     |                                       use of the Intel(R) MPI 
     |                                       Benchmarks name and trademark.
     |
     +-- \src_cpp              Product source "CPP" code and Makefiles. 
     |
     +-- \WINDOWS              Microsoft* Visual Studio* project files. 
     |
     +-- Readme_IMB.txt        Readme file providing the basic information
                               about the product (this file).

What's New

New in Intel(R) MPI Benchmarks 2021.8

New in Intel(R) MPI Benchmarks 2021.7

New in Intel(R) MPI Benchmarks 2021.6

New in Intel(R) MPI Benchmarks 2021.5

New in Intel(R) MPI Benchmarks 2021.4

New in Intel(R) MPI Benchmarks 2021.3

New in Intel(R) MPI Benchmarks 2021.2

New in Intel(R) MPI Benchmarks 2021.1

New in Intel(R) MPI Benchmarks 2019 Update 6

New in Intel(R) MPI Benchmarks 2019 Update 5

New in Intel(R) MPI Benchmarks 2019 Update 4

New in Intel(R) MPI Benchmarks 2019 Update 3

New in Intel(R) MPI Benchmarks 2019 Update 2

New in Intel(R) MPI Benchmarks 2019 Update 1

New in Intel(R) MPI Benchmarks 2019

New in Intel(R) MPI Benchmarks 2018 Update 1

New in Intel(R) MPI Benchmarks 2018

New in Intel(R) MPI Benchmarks 2017 Update 1

New in Intel(R) MPI Benchmarks 2017

New in Intel(R) MPI Benchmarks 4.1 Update 1

New in Intel(R) MPI Benchmarks 4.1

New in Intel(R) MPI Benchmarks 4.0 Update 2

New in Intel(R) MPI Benchmarks 4.0 Update 1

New in Intel(R) MPI Benchmarks 4.0

Command-Line Control

You can get help on the Intel(R) MPI Benchmarks from the command line using the component name and the -help parameter. For example, for the IMB-MPI1 component, run: IMB-MPI1 -help

You can see the Intel(R) MPI Benchmarks User's Guide for details on the command-line parameters.

Building Instructions for Linux* OS

1) Set the CC variable to point to the appropriate compiler wrapper, mpiicc or mpicc. 2) Run one or more Makefile commands below:

make clean - remove legacy binary object files and executable files make IMB-MPI1 - build the executable file for the IMB-MPI1 component make IMB-EXT - build the executable file for one-sided communications benchmarks make IMB-IO - build the executable file for I/O benchmarks make IMB-NBC - build the executable file for IMB-NBC benchmarks make IMB-RMA - build the executable file for IMB-RMA benchmarks make all - build all executable files available

3) Run the benchmarks as follows:

mpirun -n IMB- [arguments]

where is one of the make targets above. For details, refer to the Intel(R) MPI Benchmarks User's Guide at: https://www.intel.com/content/www/us/en/docs/mpi-library/user-guide-benchmarks/2021-2/overview.html

Building Instructions for Windows* OS

Use the enclosed solution files located in the component-specific subdirectories under the imb/WINDOWS directory. Click on the respective ".vcproj" or ".vcxproj" project file and use the Microsoft Visual Studio menu to run the associated benchmark application.

Building "x64" Executable Files

1) Check that the Include, Lib, and Path environment variables are set as follows: %I_MPI_ROOT%\intel64\include %I_MPI_ROOT%\intel64\lib %I_MPI_ROOT%\mpi\intel64\bin The %I_MPI_ROOT% environment variable is set to the Intel(R) MPI Library installation directory.

2) Open the ".vcproj" or ".vcxproj" file for the component you would like to build. From the Visual Studio Project panel: a) Change the "Solution Platforms" dialog box to "x64". b) Change the "Solution Configurations" dialog box to "Release". c) Check other settings as required, for example: General > Project Defaults

3) Use F7 or Build > Build Solution to create an executable.

For details, refer to the Intel(R) MPI Benchmarks User's Guide at: https://www.intel.com/content/www/us/en/docs/mpi-library/user-guide-benchmarks/2021-2/overview.html

Copyright and Licenses

See the license files in the imb/license directory.

Notices & 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.

Security Policy

See SECURITY for more information.