Intel® MKL 11.0 Install Guide

Please see the following links available online for the latest information regarding the Intel® Math Kernel Library (Intel® MKL):

Links to documentation, help, and code samples can be found on the main Intel MKL product page. For technical support visit the Intel MKL technical support forum and review the articles in the Intel MKL knowledgebase.

Please register your product using your preferred email address. This helps Intel recognize you as a valued customer in the support forum and insures that you will be notified of product updates. You can read Intel's Online Privacy Notice Summary if you have any questions regarding the use of your email address for software product registration.


Introduction

These instructions assume a standalone installation of Intel MKL. If your copy of Intel MKL was included as part of one of our "suite products" (e.g., Intel® Visual Fortran Composer XE ) your installation procedure may be different than that described below; in which case, please refer to the readme and installation guides for your "suite product" for specific installation details. A table outlining which version of Intel MKL is included in each of our suite products is available here. You can also install the standalone version of Intel MKL alongside these other products, using the instructions below.

Note: this version of Intel MKL is installed as a component of the Intel Composer XE products, meaning that the directory structure of Intel MKL has been combined with that of the compiler. Intel MKL no longer has a distinct installation directory, it is located in a subdirectory of the Compiler's main directory.

Before installing Intel MKL, check the Product Downloads section of Intel® Registration Center to see if a newer version of the library is available. The version included on your CD or listed in your electronic download license letter may not be the most current version available.

If you have a previous version of Intel MKL installed you do not need to uninstall it before installing a new version. If you choose to uninstall the older version, you may do so at any time.

Intel MKL Library Directory Layout

The default installation directory for a standalone installation of Intel MKL is:

  • Windows* OS:  C:\Program Files\Intel\ComposerXE-2013\mkl\
  • Linux* OS:  /opt/intel/composerxe-2013/mkl/

In the text that follows, <arch> refers to the primary processor architecture, such as ia32 or intel64 and <MKLROOT> refers to the Intel MKL installation directory. Additionally, substitute a '/' below for the '\' if your system is a Linux* OS or OS* X system.

Within the Intel MKL root installation directory you will find a collection of subdirectories.

<MKLROOT>\bin\<arch>\ The bin directory contains scripts recommended for configuring the environment for the purpose of building the library and or library components.

<MKLROOT>\include\ The include directory contains the interface files defining data types and function prototypes for Intel MKL. See the getting started page for more information.

<MKLROOT>\lib\<arch>\ The lib directories contain the actual library files that you must link against when building your Intel MKL application. These include the Intel MKL static library files and the stub library files needed to build applications that link with the Intel MKL dynamic or shared library files. This library does not contain the dynamic library files you need to redistribute with your application if you choose to link against the shared library files, those files are stored elsewhere (see below).

<MKLROOT>\tools\ The tools directories contain tools that are useful, but not necessary, to facilitate building Intel MKL applications.

<MKLROOT>\benchmarks\ The benchmarks directory contains the Intel® Optimized LINPACK and Intel® Optimized MP LINPACK benchmark for clusters. They are also available as a separate download.

<MKLROOT>\interfaces\ The interfaces directories contain alternate interfaces for high-level languages or for compatibility with other libraries.

<MKLROOT>\examples\ The examples directories contain alternate interfaces for high-level languages or for compatibility with other libraries.

<MKLROOT>\..\redist\<arch>\mkl\ The Intel MKL redist directory contains those Intel MKL dynamic libraries that you may distribute with your Intel MKL application when linking against the shared libraries. (Note the ..\ directory reference; the redist directory is located outside of the normal mkl directory.)

 

<MKLROOT>\..\redist\<arch>\compiler\ The common compiler redist directory contains additional dynamic libraries that you may need to distribute with your Intel MKL application when linking against the shared libraries. In particular, the Intel MKL library utilizes the Intel OpenMP library to implement multi-threading, and those OpenMP library files can be found in this directory.

Other optional or informational directories may also be present in the <MKLROOT> directory.

Installing Intel MKL on a Microsoft* Windows* OS System

You can install multiple versions of Intel MKL and any combination of 32-bit and 64-bit variations of the library on your development system. Each standalone installation of Intel MKL includes the full set of SIMD microarchitectures supported by Intel MKL.

These instructions assume you to have an internet connection. The installation program will automatically download a license key to your system. If you do not have an internet connection, see the manual installation instruction section below.

  1. If you received the Intel MKL product on CD-ROM, inserting the CD into your CD-ROM drive should automatically start the setup program. If the setup program does not start, locate the file named setup.exe on the CD and double-click it.
  2. If you received the Intel MKL product as a download, double-click on the downloaded file to begin.
  3. You will be asked to choose an installation directory ("C:\Program Files\Intel\Downloads" by default) in which the contents of the self-extracting setup file will be placed before the actual library installation begins. After installation is complete, these install files will still be located in this directory. (You can safely remove the files in this "downloads" directory if you need to free up disk space; however, deleting these files will impact your ability to change your installation options at a later time using the add/remove applet, you will always be able to uninstall.)
  4. Click Next when the installation wizard appears.
  5. If you agree with the End User License Agreement, click Next to accept the license agreement.
  6. License Activation Options:
    a) If you do have an Internet connection, skip this step and proceed to the next numbered step (below).
    b) If you do not have an Internet connection, or require a floating or counted license installation, choose Advanced Activation and click Next; there will be two options to choose from:
    - I want to use another computer with internet access to activate my license.
    Choosing this option will take you through four steps for "Remote Activation."
    - I want to use a license file to activate my software.
    Choosing this option will cause you to skip the next step.
  7. Enter your serial number to activate and install the product.
  8. Activation completed. Click Next to continue.
  9. On the dialog box Intel(R) Software Improvement Program you can opt-in for providing Intel anonymous usage information about this product to help guide future product design.
  10. If there is package from another update of Composer XE 2013 bundle (C++ Composer XE 2013, Fortran Composer XE 2013, MKL 11.0, …) installed, you will be able to select update mode on Choose Product Update Mode dialog:
    1. I want to apply this update to the existing version

      Using this option will result in the original version being replaced by the updated version.

    2. I want to install this update separate from the existing version

      Using this option will result in the update being installed in a different location, leaving the existing version unchanged.

  11. Choose the Installation Type:
    1. Full installation (Recommended)

      If you select this option, the installer takes you to the Installation Summary dialog box. Proceed to step 16.

    2. Custom installation (for Advanced Users).
  12. In the Choose a Destination Folder dialog box, choose the installation directory. By default, it is C:\Program Files\Intel. You may choose a different directory. All files are installed into the Composer XE 2013 subdirectory (in case if you chose I want to install this update separate from the existing version all files will be installed into the Composer XE 2013., where xxx is the package number).
  13. In the Select Components to Install dialog box, which displays next, you can deselect components that are not required.
  14. Package contains components for integration into Microsoft* Visual Studio*. If you didn’t unselected it on the Select Components to Install dialog box, then you will be able to select the Microsoft Visual Studio product(s) for integration on the Choose Integration Target dialog box.
  15. If Microsoft Compute Cluster Pack* is present, and the installation detects that the installing system is a member of a cluster, the dialog box will be shown which provides you an option to install the product on all visible nodes of the cluster or on the current node only (by default installation on all visible nodes is performed).
  16. The Installation Summary dialog box opens to show the summary of your installation options (chosen components, destination folder, etc.). Click Install to start installation.
  17. Click Finish in the final screen to exit the Intel Software Setup Assistant.

Silent Installation

Silent installation enables you to install Intel MKL on a single Windows* machine in a batch mode, without input prompts. Use this option if you need to install on multiple similarly configured machines, such as cluster nodes.

To invoke silent installation,

  • Go to the folder where the Intel MKL package was extracted during installation; by default, it is the C:\Program Files\Intel\Download\w_mkl_11.0.y.xxx folder.
  • Run setup.exe, located in this folder, as follows: Setup.exe command arguments

If no command is specified, the installation proceeds in the Setup Wizard mode. If a command is specified, the installation proceeds in the non-interactive (silent) mode.

The table below lists possible values of and the corresponding arguments.

Command

Required Arguments

Optional Arguments

Action

install

output=<file>,

eula={accept|reject}

installdir=<installdir>,

license=<license>,

sn=<s/n>,

log=<log file>

Installs the product as specified by the arguments:

  • Use the output argument to define the file where the output will be redirected. This file contains all installer's messages that you may need: general communication, warning, and error messages.
  • Explicitly indicate by eula=accept that you accept the End-user License Agreement.
  • Use the license argument to specify a file or folder with the license to be used to activate the product. If a folder is specified, the installation program searches for *.lic files in the specified folder. You can specify multiple files/folders by supplying this argument several times or by concatenating path strings with the ";" separator.
  • Use the sn argument to choose activation of the product through a serial number. This activation method requires Internet connection.
  • Do not use the sn and license arguments together because they specify alternative activation methods. If you omit both arguments, the installer only checks whether the product is already activated.
  • Use the log argument to specify the location for a log file. This file is used only for debugging. Support Engineers may request this file if your installation fails.

remove

output=<file>

log=<log file>

Removes the product. See the description of the install command for details of the output and log arguments.

repair

output=<file>

log=<log file>

Repairs the existing product installation. See the description of the install command for details of the output and log arguments.

For example, the command line
Setup.exe install -output=C:\log.txt -eula=accept
launches silent installation that prints output messages to
the C:\log.txt file.

Uninstalling Intel MKL

To uninstall Intel MKL, select it in the Add or Remove Programs from the Control Panel.

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

License File Installation for Windows* OS

If you have an evaluation license and decide to upgrade to a commercial license, you must complete the following steps after obtaining the commercial serial number:

  1. Replace your evaluation license file (.lic file) with the commercial license file you received in the license file directory (the default license directory is "C:\Program Files\Common Files\Intel\Licenses").
  2. Register the new serial number at https://registrationcenter.intel.com.
  3. Re-installation of Intel MKL is not required.

Uninstalling Intel MKL for Windows* OS

To uninstall Intel MKL, select Add or Remove Programs from the Control Panel and locate the version of Intel MKL you wish to uninstall.

Uninstalling Intel MKL will not delete any corresponding license files.

Installing Intel MKL on a Linux* OS System

You can install multiple versions of Intel MKL and any combination of 32-bit and 64-bit variations of the library on your development system. Each standalone installation of Intel MKL includes the full set of SIMD microarchitectures supported by Intel MKL.

  1. If you received the product as a downloadable file, first unpack the Intel MKL package in a directory to which you have write access: > tar -zxvf name_of_downloaded_file
  2. If you received the product on DVD, mount the DVD
  3. Change the directory (cd) to the directory containing unpacked files or to the top-level directory of the mounted DVD.
  4. Run the installation script and follow the instructions in the dialog screens that are presented:  > ./install.sh
  5. If you are not logged in as root, you will be asked if you want to install as root for system-wide access for all users or install as current user to limit access to user level. For the first option you can use either root or sudo privileges and password.
  6. The install script checks your system and displays any optional and critical prerequisites necessary for a successful install. You should resolve all critical issues before continuing the installation. Optional issues can be skipped, but it is strongly recommended that you fix all issues before continuing with the installation.
  7. You will be prompted to read the End User License Agreement (EULA) which you can accept or decline. You must accept the EULA to complete the installation.
  8. Press Enter to proceed.
  9. Choose the way to activate or evaluate the product following the instructions on Activation dialog.
  10. If you agree to participate in Intel(R) Software Improvement Program select “Yes” on corresponding dialog or proceed with default option (do not participate).
  11. After this you can start the installation with default installation directory, or customize it.
  12. At the end of the installation you will be prompted to create your support account. Please follow the instructions provided. If you do not wish to register at this time, press q or Enter to finish.

Silent Installation on Linux* System

  • To run the silent install, follow these steps:
    • Make sure that a working product license is in place before beginning. The file should be world-readable and located in a standard Intel license file directory, such as /opt/intel/licenses.
    • Create / edit a silent install INI file. Here is an example file. A similar file can be edited and placed in any directory on the target system. ACTIVATION=exist_lic ACCEPT_EULA=accept PSET_INSTALL_DIR=/opt/intel/composer_xe_2013.0.079 CONTINUE_WITH_INSTALLDIR_OVERWRITE=yes CONTINUE_WITH_OPTIONAL_ERROR=yes INSTALL_MODE=RPM SEND_USAGE_DATA=no
  • Run the silent install:

    > ./install.sh --silent /tmp/my_silent_config.ini

License File Installation for Linux* OS

If you have an evaluation license and decide to upgrade to a commercial license, you must complete the following steps after obtaining the commercial serial number:

  1. Replace your evaluation license file (.lic file) with the commercial license file you received in the license file directory (the default license directory is /opt/intel/licenses).
  2. Register the new serial number at https://registrationcenter.intel.com.
  3. Re-installation of Intel MKL is not required.

Uninstalling Intel MKL for Linux* OS

If you installed as root, you will need to log in as root.

To uninstall Intel MKL run the uninstall script: <MKL-install-dir>/uninstall.sh.

If you installed in the default directory, use:
> /opt/intel/composerxe-2013.x.yyy/bin/uninstall.sh

Select specific components you wish to uninstall or press “0” to select all of them. After this press “Enter” to start uninstallation for selected components

Uninstalling Intel MKL will not delete your license file(s).

Obtaining Technical Support

As a registered customer you are eligible to receive direct, secure technical support for the tools provided with this product and technical information, including FAQ's and product updates, via the Intel® Premier Support web site. Please register here using your product serial number.

If you are having trouble registering your product, or are unable to access your Intel® Premier Support account, please contact us here.

If your distributor provides technical support for this product, please contact them rather than Intel.

For information about Intel MKL-FAQ's, tips and tricks, users forums, and other support information-please visit the Intel MKL Support Website. For general product support please visit http://www.intel.com/software/products/support/.

Para obter informações mais completas sobre otimizações do compilador, consulte nosso aviso de otimização.