Intel® IPP 7.0 Library Installation Guide

Please see the following links for the latest information regarding the Intel® Integrated Performance Primitives (Intel® IPP) library:

Links to documentation, help, and code samples can be found on the main Intel IPP product page. For technical support visit the Intel IPP technical support forum and review the articles in the Intel IPP 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.

How to Build an IPP Application provides an introduction to compiling, linking and deploying Intel IPP applications.

Introduction

These instructions assume a standalone installation of the IPP library. If your copy of the IPP library was included as part of one of our "suite products" (Intel Composer, Intel Parallel Studio, etc.) your installation procedure may differ slightly from that described below; in which case, please refer to the readme and installation guides for your "suite product" for detailed installation details. A table outlining which version of the IPP library is included in each of our suite products is available here. You can install the standalone version of the IPP library alongside these other products, using the instructions below.

Note: this version of the IPP library is installed as a component of the Intel Composer product, meaning that the directory structure of the IPP library has been combined with that of compiler and related Intel developer products. The IPP library no longer has a distinct installation directory, it is located in a subdirectory of the main Composer directory.

Before installing the Intel IPP library, check the Product Downloads section of the 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 (lower numbered) version of the Intel IPP library installed it is not necessary to uninstall it before installing a new version. If you choose to uninstall the older version, you may do so at any time.

The cryptography component of the Intel IPP library is subject to US Export Administration Regulations and other US laws. To obtain the Intel IPP cryptography library component, which must be downloaded separately, please review this article from the IPP knowledge base describing how to download the cryptography library.

IPP Library Directory Layout

The default installation directory for a standalone installation of the IPP library is:

  • Windows: C:\Program Files\Intel\ComposerXE-2011\ipp\
  • Linux: /opt/intel/composerxe-2011/ipp/

For "side-by-side" installations (multiple copies of the library are installed), the IPP root directory is located here:

  • Windows: C:\Program Files\Intel\ComposerXE-2011.x.yyy\ipp\
  • Linux: /opt/intel/composerxe-2011.x.yyy/ipp/

Where 'x' and 'yyy' are version specific numbers.

In the text that follows, <arch> refers to the primary processor architecture, such as ia32 or intel64 and <IPPROOT> refers to the IPP installation directory. Additionally, substitute a '/' below for the '\' if you are installing on a Linux system.

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

<IPPROOT>\bin\<arch>\ The bin directory contains applications that are either necessary or recommended for the purpose of building the library and or library components.

<IPPROOT>\lib\<arch>\ The lib directories contain the actual library files that you must link against when building your IPP application. These include the IPP static library files and the stub library files needed to build applications that link with the IPP 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).

<IPPROOT>\tools\<arch>\ The tools directories contain tools that are useful, but not necessary, to facilitate building IPP applications. Of particular interest are the perfsys performance measurement tool, which can be used to measure the relative performance of IPP functions and the header files needed to build processor-specific IPP applications (applications that do not utilize the IPP dispatcher).

<IPPROOT>\interfaces\ The interfaces directories include high-level applications and/or libraries that utilize the IPP library. In many cases these are implementations of popular open source application libraries that have been modified to use the IPP library and are provided ready to use with your application. For example, several popular data compression libraries can be found here. Source and pre-built binaries can be found in these directories.

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

<IPPROOT>\..\redist\<arch>\compiler\ The common compiler redist directory contains additional dynamic libraries that you may need to distribute with your IPP application. In particular, the IPP 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 located in the <IPPROOT> directory.

Installing the Intel IPP Library on a Microsoft* Windows* System

See How to Install the Intel IPP 7.0 Library on Windows for detailed step-by-step instructions with screenshots.

You can install multiple versions of the IPP library and any combination of 32-bit and 64-bit variations of the library on your development system. Each standalone installation of the IPP library includes the full set of SIMD microarchitectures supported by the IPP library. See Understanding CPU Dispatching in the Intel IPP Library for more information about the SIMD microarchitectures included in the IPP library.

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 IPP 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 IPP 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. Choose an install location. The default directory is "C:\Program Files\Intel". Click Next to continue.
  10. Select the components to be installed and click Next to continue.
  11. Installation of the IPP library will begin.
  12. When the installation has completed you will be prompted to Finish by an Installation Complete message.

License File Installation for Windows

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 the IPP library is not required.

Uninstalling the Intel IPP Library for Microsoft* Window*

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

Uninstalling the Intel IPP library will not delete any corresponding license files.

Installing the Intel IPP Library on a Linux* System

You can install multiple versions of the IPP library and any combination of 32-bit and 64-bit variations of the library on your development system. Each standalone installation of the IPP library includes the full set of SIMD microarchitectures supported by the IPP library. See Understanding CPU Dispatching in the Intel IPP Library for more information about the SIMD microarchitectures included in the IPP library.

These instructions use the IA-32 package as an example. These instructions are the same for all packages other than the names of the packages and directories.

  1. Unpack the Intel IPP package in a directory to which you have write access:
    > tar zxvf l_ipp_ia32_p_7.0.x.yyy.tgz
  2. Run the installation script in the directory where the tar file was extracted and follow the instructions in the dialog screens that are presented:
    > cd l_ipp_ia32_p_7.0.x.yyy
    > ./install.sh
  3. You will be prompted to read the EULA which you can accept or decline. You must accept the EULA to complete the installation.
  4. If you are not logged in as root, you will be asked if you want to install as root (which will update the system RPM database) or install not as root (which won't use the system RPM database). Use the non-root install if you wish to install in a private location.
  5. 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.
  6. The install may prompt you to specify install paths and/or press Enter to proceed.
  7. At the end of the installation you will be prompted to register with Intel Premier Support. Please follow the instructions provided. If you do not wish to register at this time, press q and Enter to finish.

Linux Installation Warning Notes

RPM 4.0.2 cannot install to a non-default directory. This has been resolved in RPM 4.0.3.
RPM 4.1 cannot install to a non-default directory. This has been resolved in RPM 4.11 thru 4.2.

License File Installation for Linux

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 the IPP library is not required.

Uninstalling the Intel IPP Library for Linux*

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

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

If you installed in the default directory, use:
> /opt/intel/composerxe-2011/ipp/[ia32 | intel64t ]/uninstall.sh

Uninstalling the Intel IPP library will not delete your license file(s).

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