Introduction

This document explains how to install and configure the Intel® MPI Library for Linux* OS. Installation is a multi-step process. Read this document in its entirety before beginning, and follow the steps in sequence. For information about the product contents, including new and changed features, refer to the separate Release Notes.

If you have a previous version of the Intel® MPI Library for Linux installed, you do not need to uninstall it before installing this version. If you choose to uninstall the older version, you may do so before or after installing this version.

System Requirements

The following section describes supported hardware.

Systems based on the Intel® 64 architecture:

Obtaining the Intel® MPI Library

Before installing the Intel® MPI Library, you should check the Intel® Registration Center to see if a newer version or an update is available. The version on CD or as listed in your electronic download license letter may not be the most current.

Installing the Intel® MPI Library

Pre-Installation Instructions

Make sure that the following packages are installed on your system:

Installation Instructions

Installation in Command Line Mode

To install the Intel® MPI Library package on Linux* OS using the command line mode, follow these steps:

  1. Upon registering for the Intel® MPI Library, you will receive a serial number for this product. Your serial number can be found within the email receipt of your product purchase. Go to the Intel® Registration Center site and provide the product serial number information. Once admission has been granted into the registration center, you will be able to access the Intel® Premier Web pages for software support.

  2. Extract the l_mpi[-rt]_p_<version>.<package_num>.tar.gz package by using following commands


    # cp l_mpi[-rt]_p_<version>.<package_num>.tar.gz /tmp

    # cd /tmp

    # tar -xzf l_mpi[-rt]_p_<version>.<package_num>.tar.gz


    The last command will create the subdirectory l_mpi[-rt]_p_<version>.<package_num>

     
  3. (SDK only) Place the license file for the Intel MPI Library that is provided to you in /tmp/l_mpi_p_<version>.<package_num>. Do not change the file name as the ".lic" extension is critical. For instance, do the following:


    # cd l_mpi_p_<version>.<package_num>

    # cp <license key>.lic .


    If you want use the Intel® Software License Manager activation by selecting the following option, check Intel® MPI Library for Linux* OS Release Notes to ensure that your license supports this activation type.

    I want to activate by using a license file, or by using a Intel(R) Software License Manager -> Use a Intel(R) Software License Manager

  4. If you want to install the Intel MPI Library on all nodes of your cluster without using a shared file system, create a machines.LINUX file. Otherwise go to step 6.

     

    The machines.LINUX file contains a list of the computing nodes (for example, the host names) for the cluster, one hostname per line. The hostname should be the same as the result from the Linux* OS command "hostname". For example, if a cluster consists of four nodes, the file machines.LINUX might look like:

    clusternode1
    clusternode2
    clusternode3
    clusternode4

    It is always assumed that the first node in the list is the master node. The remaining nodes are the compute nodes.

     
  5. If you want to automatically establish secure shell connectivity between all nodes of the cluster, use the script file sshconnectivity.exp. Otherwise go to step 6.

     

    You can download the expect software package from the following URL: http://expect.nist.gov/

     

    The syntax for the sshconnectivity.exp command is:


    ./sshconnectivity.exp machines.LINUX


    This expect shell script will create or update the ~/.ssh directory on each cluster node mentioned in the machines.LINUX file. This script will prompt you for your password twice.


    Enter your user password:

    Re-enter your user password:


    To provide security each time you enter your user password, asterisks will appear in lieu of the password text. Upon successful completion of the script, the following message fragment will appear:

    …
    *********************************************************************
    Node count = 4
    Secure shell connectivity was established on all nodes.
    …
    *********************************************************************
    …

    A log of the transactions for this script will be recorded in /tmp/sshconnectivity.<userid>.log,

    where the <userid> stands for your actual login name.

    Note: The sshconnectivity.exp script will remove the write access permission for your home directory for everybody but you. If this cannot be done, a password prompt will still be issued for any secure shell activity.

     
  6. Execute the install script:


    # ./install.sh

     
  7. If you started installation as an ordinary user, you will be prompted for a choice. Make a choice and hit the enter key.

     

    Please make your selection by entering an option.

    Root access is recommended for evaluation.

     

    1. Run as a root for system wide access for all users [default]

    2. Run using sudo privileges and password for system wide access for all users

    3. Run as current user to limit access to user level

     

    h. Help

    q. Quit

     

    Please type a selection [1]:


    If you start installation as root, the message above does not appear.


  8. The Welcome dialog box appears:

     

    --------------------------------------------------------------------------------

     Step 1 of 6 | Welcome

    --------------------------------------------------------------------------------

     Welcome to the Intel(R) MPI Library, Development Kit 5.0 Update 2 for Linux* OS    

     installation program

     

    --------------------------------------------------------------------------------

     You will complete the steps below during this installation:

     Step 1 : Welcome

     Step 2 : License agreement

     Step 3 : Activation

     Step 4 : Options

     Step 5 : Installation

     Step 6 : Complete

    --------------------------------------------------------------------------------

     Press "Enter" key to continue or "q" to quit:


  9. The End User License Agreement dialog box appears:

     

    --------------------------------------------------------------------------------

     Step 2 of 6 | License agreement

    --------------------------------------------------------------------------------

     As noted in the Intel (R) Software Development Products End User License

     Agreement, the Intel (R) Software Development Products you install will send Intel

     the product's serial number and other system information to help Intel improve

     the product and validate license compliance. No personal information will be

     transmitted.

    --------------------------------------------------------------------------------

     To continue with the installation of this product you are required to accept the

     terms and conditions of the End User License Agreement (EULA). The EULA is

     displayed using the "more" utility. Press the spacebar to advance to the next

     page or enter "q" to skip to the end. After reading the EULA, you must enter

     "accept" to continue the installation or "decline" to return to the previous

     menu.

    ------------------------------------------------------------------------------
     IMPORTANT - READ BEFORE COPYING, INSTALLING OR USING.

      Do not copy, install, distribute, public display, or use the Materials provided

      under this license agreement ("Agreement"), until you have carefully read the

      following terms and conditions. 


  10. Select the activation method you want to use:

     

     Step 3 of 6 | Activation

    --------------------------------------------------------------------------------

     If you have purchased this product and have the serial number and a connection

     to the internet you can choose to activate the product at this time. Activation

     is a secure and anonymous one-time process that verifies your software licensing

     rights to use the product. Alternatively, you can choose to evaluate the product

     or defer activation by choosing the evaluate option. Evaluation software will

     time out in about one month. Also you can use license file, Intel(R) Software License Manager.

    --------------------------------------------------------------------------------

     1. I want to activate my product using a serial number [default]

     2. I want to evaluate my product or activate later

     3. I want to activate by using a license file, or by using Intel(R) Software License Manager

     

     h. Help

     b. Back to the previous menu

     q. Quit

    --------------------------------------------------------------------------------

     Please type a selection or press "Enter" to accept default choice [1]:


  11. Assuming you select option 2 as the activation method, the Advanced activation dialog box appears as the following screen. If you select option 3, the advanced activation dialog appears. 

     

     Activation > Alternative activation

    --------------------------------------------------------------------------------

     Your license file is available for download from

      https://registrationcenter.intel.com. Further instructions are available at

      http://software.intel.com/en-us/articles/offline-activation-of-intel-software-development-

      products.

     The Intel(R) Software License Manager User's Guide explains how to download,

     install, configure and troubleshoot the Intel(R) Software License Manager. The

     guide is available at: 

     http://software.intel.com/en-us/articles/license-manager-for-flexlm-users-guide. 

    --------------------------------------------------------------------------------

     1. Activate offline

     2. Use Intel(R) Software License Manager

     

     h. Help

     b. Back to the previous menu

     q. Quit

    --------------------------------------------------------------------------------

     Please type a selection or press "Enter" to accept default choice [1]:

     


  12. If you select to activate the product offline, you will be prompted for the license file location. Provide a directory path to where the license file resides or the full license file name.

    If you want use the Intel® Software License Manager activation by selecting the following option, check Intel® MPI Library for Linux* OS Release Notes to ensure that your license supports this activation type.

    I want to activate by using a license file, or by using a Intel(R) Software License Manager -> Use a Intel(R) Software License Manager

  13. After activation, you will see the following dialog box. To finish the configuration, select option 1. To install the product on cluster compute nodes, select option 2. By default, it is installed only on the head node.  

     Step 4 of 6 | Options

    --------------------------------------------------------------------------------

     This product can be installed on cluster nodes.

    --------------------------------------------------------------------------------

     1. Finish configuring cluster [default]

     

     2. Configuration type                            [ Current node ]

     

     h. Help

     b. Back to the previous menu

     q. Quit

    --------------------------------------------------------------------------------

     Please type a selection or press "Enter" to accept default choice [1]:

  14. If you choose to finish configuring cluster, you will see the Pre-install Summary dialog box:

     

     Step 4 of 6 | Options > Pre-install Summary

    --------------------------------------------------------------------------------

    Install location:

    /opt/intel/impi/<version>.<package_num>

    Component(s) selected:

    Intel(R) MPI Library, Development Kit 5.0 Update 2 728MB

    Intel(R) MPI Library, Runtime Environment for applications running on Intel(R) 64 Architecture

    Intel(R) MPI Library, Runtime Environment for applications running on

    Intel(R) Many Integrated Core Architecture

    Intel(R) MPI Library for applications running on Intel(R) 64 Architecture

    Intel(R) MPI Library for applications running on Intel(R) Many Integrated Core Architecture

    Install Space Required: 728MB

    Cluster installation type:

    Product will be installed on a single node 

    1. Start installation Now [default]

    2. Customize installation

    h. Help

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice [1]:


  15. If you choose to customize installation, the Options dialog box appears:

     

     Step 4 of 6 | Options

    --------------------------------------------------------------------------------

     You are now ready to begin installation. You can use all default installation

     settings by simply choosing the "Start installation Now" option or you can

     customize these settings by selecting any of the change options given below

     first. You can view a summary of the settings by selecting

     "Show pre-install summary".

    --------------------------------------------------------------------------------

     1. Start installation Now  [default]

     

     2. Change install directory      [ /opt/intel/impi/<version>.<package_num> ]

     3. Change components to install  [ Custom ]

     4. Change advanced options     

     5. Show pre-install summary

     

     h. Help

     b. Back to the previous menu

     q. Quit

    --------------------------------------------------------------------------------

     Please type a selection or press "Enter" to accept default choice [1]:


  16. Select Change advanced options to change mpi-selector, environment modules, and ld.so.conf configuration:

     

     Step 4 of 6 | Options | Advanced Options

    --------------------------------------------------------------------------------

     Specify mpi-selector and ld.so.conf options

    --------------------------------------------------------------------------------

     1. Finish setting advanced options [default]

      2. Register in mpi-selector [ no ] 

     3. Add library to configuration file [ no ]

     

     h. Help

     b. Back to the previous menu

     q. Quit

    --------------------------------------------------------------------------------

     Please type a selection or press "Enter" to accept default choice [1]:


  17. To start installation immediately, select option 1. To change mpi-selector, select option 2. To change ld.so.conf configuration, select option 3.

     

  18. When the installation is completed, the Complete dialog appears:

     

     Step 6 of 6 | Complete

    --------------------------------------------------------------------------------

     Thank you for installing and for using the Intel(R) MPI Library, Development Kit 5.0 Update 2 for Linux* OS.

     

     Support services start from the time you install or activate your product. If

     you have not already done so, please create your support account now to take

     full advantage of your product purchase.

     

     Your support account gives you access to free product updates and upgrades as

     well as interactive technical support at Intel(R) Premier Support.

     

     To create your support account, please visit the Intel (R) Software Development

     Products Registration Center web site

     https://registrationcenter.intel.com/RegCenter/registerexpress.aspx?media=L96.

    --------------------------------------------------------------------------------

     q. Quit [default]

    --------------------------------------------------------------------------------

     Please type a selection or press "Enter" to accept default choice [q]:

     

Installation in Graphical User Interface Mode

There is a prerequisite: X-server should be up and running.

To install the Intel® MPI Library package on Linux* OS using the graphic user interface, follow these steps:

  1. Invoke the Graphical User Interface installation by entering the following command:

    ./install.sh --gui-mode

  2. In the User Selection dialog box, select the corresponding option to indicate that you want to install as a root, install as a root using sudo command, or install as a current user. Click Next to continue.                                                  

  3. The Welcome dialog box appears. Click Next to continue.

  4. In the License agreement dialog, read and accept the terms of End User License Agreement. Click Next to continue.

  5. In the Activation dialog, you may be asked to select an activation type. Select the preferred type and provide additional information (existing license file or serial number). Click Next to continue.

  6. Assuming you select alternative activation, the Alternative activation dialog box appears. In this dialog box, you can choose whether to activate offline, or use Intel(R) Software License Manager.

  7. The Installation Summary dialog appears.

    If you want to specify the installation directory, choose the components for installation, or enable installation to cluster computer nodes, click Customize installation.

    If you want to continue the installation with the default settings, click Install and go to step 12.

  8. Assuming that you select the customize installation, the Choose a Destination Folder dialog appears. In this dialog box, enter the directory that you want to install the product. Click Next to continue.

  9. The Select Components to Install dialog appears. In this dialog box, select the components that you want to install. Click Next to continue.

  10. The Cluster dialog appears. In this dialog, select the method that you want to install. To install the product on the cluster, select Product will be installed on every node… and provide a path to the machines file. Click Next to continue.

  11. MPI Advanced Options dialog appears. You can change environment modules, mpi-selector, and ld.so.conf configuration in this dialog.

  12. The Installation Summary dialog appears. To start the installation, click Next on the Installation Summary dialog, and the Complete dialog appears.

  13. Click Finish to complete the installation.

Installer Options 

--cli-mode

Run the installation in the command-line mode

-d, --duplicate [FILE]

Run the installation interactively, record the user input into the configuration file

--gui-mode

Run the installation in the graphical mode

-h, --help

Print this message

--ignore-cpu

Skip CPU mode check. Use this option when installing the Intel® MPI Library on unsupported or unrecognized CPUs.

Note:

Installing the Intel® MPI Library on unsupported or unrecognized CPUs could potentially lead to installation or runtime problems. Get the technical support at https://premier.intel.com if you believe the Intel MPI Library should work on the selected CPU.

--ignore-signature

Skip signature validation 

-l, --lang

Set the user interface language

-nonrpm-db-dir

Set the directory to store the product installation database

-s, --silent [FILE]

Run the installation silently, with the settings provided in the configuration file

--signature

Set the public key file to validate digital signature of the Red Hat* Package Manager (RPM) packages. The PUBLIC_KEY.PUB key is included in the package.

Note:

Signature verification feature is used to check authenticity of the Red Hat* Package Manager (RPM) packages. By default the installer downloads a public key from the Intel site and uses it to check packages signature.

-SHARED_INSTALL

Install to a network-mounted drive or shared file system for multiple users

-t, --tmp-dir [FOLDER]

Set a custom temporary folder

--user-mode

Run the installation with current user privileges

-v, --version

Print version information 

Silent Installation

The ./install.sh script has a silent installation mode that helps you to install the Intel MPI Library on clusters with many nodes. Edit the file silent.cfg contained in the unpacked package directory or create a new one to use for this mode. For example, you can use the following command to perform silent installation without using the rpm database:

# install.sh --silent silent.cfg

For more installation options, see the description of the environment variables below.

PSET_INSTALL_DIR

Set the prefix of the installation directory

ACTIVATION

Activation type. Possible values:

PSET_LICENSE_FILE

Set the full path to the product license, including the filename. Applicable if ACTIVATION=license_file

PSET_SERIAL_NUMBER

Serial number. Applicable if ACTIVATION=serial_number

INSTALL_MODE

Set the installation mode: RPM or NONRPM

UPDATE_LDSOCONF

Set this variable to yes to update /etc/ld.so.conf after installation. Otherwise, set to no.

AUTOMOUNTED_CLUSTER

Set this variable to yes to install the full product only on the current machine in the directory path specified by the PSET_INSTALL_DIR variable. In this case, the MACHINES_FILE variable is not applicable. Set this variable to no to install the full product on all cluster nodes of the cluster. In this case, the settings for MACHINES_FILE will be used.

MACHINES_FILE

Define a path to the machines.LINUX file that contains a list of the nodes in the cluster. Format is the same as a standard machines.LINUX file: one hostname per line.

ACCEPT_EULA

Set this variable to accept if you agree to the terms and conditions listed in license.txt. Otherwise, set to decline.

REGISTER_IN_SELECTOR

Set this variable to yes to register the Intel® MPI Library with mpi-selector.  Otherwise, set to no.

CONTINUE_WITH_INSTALLDIR_OVERWRITE

CONTINUE_WITH_OPTIONAL_ERROR

Set this variable to yes to ignore warning messages.  Otherwise, set to no.

 

Setting up the environment

Add the following PATH and/or LD_LIBRARY_PATH settings to your .cshrc or .bashrc files so that the settings are visible on all nodes in your cluster:

  1. Ensure that Python* is in your PATH.
  2. Source the appropriate mpivars.[c]sh script from the Intel® MPI Library <arch>/bin/ directory (<arch>={intel64} for Intel® 64 architecture).
  3. (SDK only) If using the Intel® Professional Edition Compilers, source any required *{icc, ifort}vars.[c]sh scripts.
  4. Set up additional environment variables as needed.
  5. See the Intel® MPI Library for Linux* OS User's Guide for more information.

Uninstalling the Intel® MPI Library

To uninstall the Intel® MPI Library, go to the Intel MPI Library installation directory and run the uninstall.sh script.

Note: Uninstalling the Intel MPI Library does not delete the corresponding license file.

Obtaining Technical Support

To receive technical support for this product, you need to be registered for an Intel® Premier Support account on our secure web site, https://premier.intel.com/. Please register at Intel® Registration Center.

Note: If you have questions or problems getting started with the Intel® MPI Library, please contact support at https://registrationcenter.intel.com/support/

For general support information please visit http://www.intel.com/software/products/support/mpi/

Disclaimer and Legal Information

By using this document, in addition to any agreements you have with Intel, you accept the terms set forth below.

You may not use or facilitate the use of this document in connection with any infringement or other legal analysis concerning Intel products described herein. You agree to grant Intel a non-exclusive, royalty-free license to any patent claim thereafter drafted which includes subject matter disclosed herein.

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS.  NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT.  EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
A "Mission Critical Application" is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death.  SHOULD YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS.

Intel may make changes to specifications and product descriptions at any time, without notice.  Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined".  Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them.  The information here is subject to change without notice.  Do not finalize a design with this information.
The products described in this document 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.
Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.
Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or go to:  http://www.intel.com/design/literature.htm

MPEG-1, MPEG-2, MPEG-4, H.261, H.263, H.264, MP3, DV, VC-1, MJPEG, AC3, AAC, G.711, G.722, G.722.1, G.722.2, AMRWB, Extended AMRWB (AMRWB+), G.167, G.168, G.169, G.723.1, G.726, G.728, G.729, G.729.1, GSM AMR, GSM FR are international standards promoted by ISO, IEC, ITU, ETSI, 3GPP and other organizations. Implementations of these standards, or the standard enabled platforms may require licenses from various entities, including Intel Corporation.

BlueMoon, BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Inside, Cilk, Core Inside, E-GOLD, Flexpipe, i960, Intel, the Intel logo, Intel AppUp, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, Intel Insider, the Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel Sponsors of Tomorrow., the Intel Sponsors of Tomorrow. logo, Intel StrataFlash, Intel vPro, Intel XScale, InTru, the InTru logo, the InTru Inside logo, InTru soundmark, Itanium, Itanium Inside, MCS, MMX, Moblin, Pentium, Pentium Inside, Puma, skoool, the skoool logo, SMARTi, Sound Mark, Stay With It, The Creators Project, The Journey Inside, Thunderbolt, Ultrabook, vPro Inside, VTune, Xeon, Xeon Inside, X-GOLD, XMM, X-PMU and XPOSYS are trademarks of Intel Corporation in the U.S. and/or other countries.

* Other names and brands may be claimed as the property of others.

Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.

Java is a registered trademark of Oracle and/or its affiliates.

Copyright (C) 2003–2014, Intel Corporation. All rights reserved.

Optimization Notice

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804