Intel® MPI Library Developer Guide for Windows* OS

Download PDF
ID 768730
Date 6/24/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
Document Table of Contents x
Intel® MPI Library Developer Guide for Windows* OS
Intel® MPI Library Developer Guide for Windows* OS x
Introduction Installation and Prerequisites Compiling and Linking Running Applications Debugging Applications Analysis and Tuning Troubleshooting Notices and Disclaimers
Introduction x
Introducing Intel® MPI Library Conventions and Symbols Related Information
Installation and Prerequisites x
Installation Prerequisite Steps User Authorization
Compiling and Linking x
Compiling an MPI Program Configuring a Microsoft Visual Studio* Project
Running Applications x
Running Intel® MPI Library in Containers Selecting a Library Configuration Running an MPI Program Running an MPI/OpenMP* Program MPMD Launch Mode Fabrics Control Job Schedulers Support Controlling Process Placement Java* MPI Applications Support
Running Intel® MPI Library in Containers x
Build a Singularity* Container for an MPI Application Run the Application with a Container
Fabrics Control x
Selecting Fabrics Libfabric* Support OFI* Providers Support
Debugging Applications x
Debugging Using -gtool for Debugging
Analysis and Tuning x
Displaying MPI Debug Information Tracing Applications MPI Tuning
Troubleshooting x
Error Message: Bad Termination Error Message: No such file or Directory Error Message: Permission Denied Error Message: Fatal Error Error Message: Bad File Descriptor Error Message: Too Many Open Files Problem: MPI Application Hangs Problem: Password Required Problem: Cannot Execute Binary File Problem: MPI limitation for Docker*
Intel® MPI Library Developer Guide for Windows* OS

Configuring a Microsoft Visual Studio* Project

NOTE:
Starting with Intel(R) MPI 2021.11, the I_MPI_ONEAPI_PATH variable is deprecated. Use the absolute installation path instead: C:\Program Files (x86)\Intel\oneAPI\mpi\<version>\.

To configure a Microsoft Visual Studio* project with Intel® MPI Library, do the following:

  1. In Microsoft Visual Studio*, create a console application project or open an existing one.

  2. Open the project properties, go to Configuration Properties > Debugging and set the following parameters:

    Command: <installation_directory>\bin\mpiexec.exe

    Command arguments: -n <processes-number> "$(TargetPath)"

    Environment for the Debug version: PATH=<installation_directory>\bin\mpi\debug;<installation_directory>\opt\mpi\libfabric\bin;$(PATH)

    Environment for the Release version: PATH=<installation_directory>\bin;<installation_directory>\opt\mpi\libfabric\bin;$(PATH)

    NOTE:
    Starting with Intel(R) MPI 2021.11, the <installation_directory>\bin\mpi\release and <installation_directory>\lib\mpi\release directories are deprecated. Use the corresponding <installation_directory>\bin\mpi\debug and <installation_directory>\lib\mpi\debug directories instead.

  3. In Configuration Properties > C/C++ or Fortran, as appropriate, set the following parameter:

    Additional Include Directories: <installation_directory>\include

  4. In Configuration Properties > Linker, set the following parameter:

    Additional Library Directories for the Debug version: <installation_directory>\lib\mpi\debug;<installation_directory>\lib

    Additional Library Directories for the Release version: <installation_directory>\lib

  5. In Configuration Properties > Linker > Input, set the following parameters:

    • For Fortran, set Additional Dependencies: impi.lib
    • For C++, set Additional Dependencies: impi.lib and impicxx.lib

After completing these steps, you can build the solution and run the application. To run the application from Visual Studio, you can use the Ctrl + F5 key combination (Start Without Debugging). For other available options, see Running Applications.

Parent topic: Compiling and Linking
Level Two Title