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.
New Installation Features
- The Intel® MPI Library Development Kit (SDK) package is installed on top of the Runtime Environment (RTO) package.
- The default installation path for the Intel® MPI Library is now /opt/intel/impi/<version>.<package_num>.
- The Installer creates symbolic links for historic installation paths /opt/intel/mpi/* and /opt/intel/mpi-rt/* to retain backward compatibility.
- The SDK installer checks for the existence of the associated RTO package and installs it if the RTO is missing. If the RTO is already present, its location determines the default SDK location.
- The RTO uninstaller checks for SDK presence and proposes to uninstall the SDK and RTO packages.
- The SDK uninstaller asks the user if the RTO is to be uninstalled as well. The user is able to cancel the uninstallation at the point.
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.
Make sure that the following packages are installed on your system:
To install the Intel MPI Library package on Linux* OS, do the following:
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.
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>
(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 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 (i.e. the host names) for the cluster, one hostname per line. The hostname should be the same as the result from the Linux 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.
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
Note that 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.
Execute the install script:
# ./install.sh
Which of the following would you like to do?
1. Install the software using RPM (root password required) - Recommended
2. Install the software without using RPM database (root password not required).
x. Exit
Please type a selection:
The message above will not appear if you start installation as root. Make a choice and hit the enter key.
Which one of the following would you like?
1. Install cluster node software on an automounted shared file system
2. Install cluster node software on every node of your cluster
x. Exit
A valid FLEXlm license is required to install this product, but none were found in
/opt/intel/licenses.
Where is a valid FLEXlm license for this product?
Enter location, or press Enter to exit.
If the license is found, but expired, the installer will report that.
Would you like to:
Install:
i. Intel® MPI Library, Development Kit for Linux* version <version#>
Uninstall:
1. intel-mpi-em64t version a.b.c
(non-rpm in "installdir/intel/impi/a.b.c")
x. Exit
Please type a selection (i/1/2/x) [i]:
Make a choice and hit enter.
Intel® MPI Library, Development Kit for Linux* version a.b.c-xxx
Please carefully read the following license agreement for the Intel® MPI Library, Development Kit for Linux* version a.b.c-xxx. Prior to installing the software you will be asked to agree to the terms and conditions of the following license agreement.
Press Enter to continue...
--- EULA Content ---
Do you agree to be bound by the terms and conditions of this license agreement?
Enter 'accept' to continue, 'reject' to exit: (accept/reject):
Enter ‘accept’ to continue.
Please specify installation prefix [installdir/intel/impi/<version>.<package_num>]
Symbolic link /opt/intel/mpi-rt/<version> -> /opt/intel/impi/<version>.<package_num> was created.
Symbolic link /opt/intel/impi/<version> -> /opt/intel/impi/<version>.<package_num> was created.
Installation successful. To uninstall this package, run "installdir/intel/impi/<version>.<package_num>/uninstall".
Installation failed. Please see log for details.
The installation log file install.log is always created during the installation. It can be found in the directory from where you started the installation.
Install components for a specified architecture
Extract product's rpm and EULA into a specified directory
Install the product to a specified path
Search the specified directory for a license
Save the log output to a specified file
Do not ask for a root password
Perform an installation without using the rpm database
Save the user's responses in a FILE
Use the specified directory for temporary files
Choose whether to update /etc/ld.so.conf or not
Perform a silent installation by using the settings from FILE
Show the help menu
Print a short usage message
Print the product version
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 SilentInstallConfigFile.ini contained in the unpacked package directory or create a new one to use this mode. See the description of the environment variables below.
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:
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.
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 http://support.intel.com/support/performancetools/support.htm and click on "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
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.
UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED
NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD
CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR.
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 by visiting
Intel's Web Site.
Intel processor numbers are not a measure of performance. Processor numbers differentiate features within each processor family, not across different processor families. See http://www.intel.com/products/processor_number for details.
BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Atom, Centrino Atom Inside, Centrino Inside, Centrino logo, Core Inside, FlashFile, i960, InstantIP, Intel, Intel logo, Intel386, Intel486, IntelDX2, IntelDX4, IntelSX2, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, Intel Inside logo, Intel. Leap ahead., Intel. Leap ahead. logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel StrataFlash, Intel Viiv, Intel vPro, Intel XScale, Itanium, Itanium Inside, MCS, MMX, Oplus, OverDrive, PDCharm, Pentium, Pentium Inside, skoool, Sound Mark, The Journey Inside, Viiv Inside, vPro Inside, VTune, Xeon, and Xeon Inside are trademarks of Intel Corporation in the U.S. and other countries.
* Other names and brands may be claimed as the property of others.
Copyright © 2007-2008, Intel Corporation. All rights reserved.