Intel® Data Analytics Acceleration Library 2016 Installation Guide

Please see the following links to the online resources and documents for the latest information regarding Intel DAAL:

These instructions assume a standalone installation of Intel® Data Analytics Acceleration Library (Intel® DAAL). If your copy of Intel® DAAL was included as part of one of our "suite products" (e.g., Intel® Parallel Studio 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.

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

The installation of the product requires a valid license file or serial number. If you are evaluating the product, you can also choose the "Evaluate this product (no serial number required)" option during installation.
If you have a previous version of Intel DAAL 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.

Directory Layout

Intel® DAAL installs in the daal subdirectory inside <parent product directory>. For example, when Intel® DAAL is installed as part of the Intel® Parallel Studio XE Composer Edition for C++, <parent product directory> is as follows:

  • On Windows* OS: C:\Program files (x86)\Intel_sw_development_tools\compilers_and_libraries_2016.x.xxx\windows (on some systems, instead of Program Files (x86), the directory name is Program Files)
  • On OS X*:  /opt/intel/compilers_and_libraries_2016.x.xxx/mac
  • Linux* OS: /opt/intel/compilers_and_libraries_2016.x.xxx/linux

In the text that follows, <arch> refers to the primary processor architecture, such as ia32 or intel64 and <DAALROOT> refers to the Intel® DAAL installation directory. Additionally, replace the '\' below with a '/' on Linux* OS or OS X*.

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

<DAALROOT>\daal\bin - Environment variables.

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

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

<DAALROOT>\documentation\en\daal -  Intel® DAAL documentation.

<DAALROOT>\daal\examples\cpp - Actual examples in C++ language.

<DAALROOT>\daal\examples\java - Actual examples in Java* language.

<DAALROOT>\daal\examples\data - Data files for C++ and Java* examples.

<DAALROOT>\daal\samples - Samples in C++ and Java* languages that you can include in your program.

<DAALROOT>\daal\include - The interface files defining data types and function prototypes for Intel® DAAL. See the Getting Started page for more information.

<DAALROOT>\redist\<arch>\daal - Intel® DAAL dynamic libraries that you may distribute with your Intel® DAAL application when linking against the shared libraries.

<DAALROOT>\tbb\lib\<arch>\vc_mt - This common directory contains additional dynamic libraries that you may need to distribute with your Intel® DAAL application when linking against the shared libraries. In particular, these are dynamic libraries from Intel® Threading Building Blocks (Intel® TBB) that Intel® DAAL utilizes for treading implementation.

Installing Intel DAAL on Windows* OS

You can install multiple versions of Intel DAAL and any combination of 32-bit and 64-bit variations of the library on your development system.

These instructions assume you to have an Internet connection. The installation program will automatically download a serial number to your system. If you do not have an internet connection, see the manual installation instructions below.

Interactive installation on Windows* OS

  1. If you received the Intel DAAL product as a download, double-click on the downloaded file to begin.
  2. You will be asked to choose a target 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. You can choose to remove or keep temporarily extracted files after installation is complete. 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.)
  3. Click Next when the installation wizard appears.
  4. If you agree with the End User License Agreement, click Next to accept the license agreement.
  5. License Activation Options:
    • If you do have an Internet connection, skip this step and proceed to the next numbered step (below).
    • If you do not have an Internet connection, or require a floating or counted license installation, choose Alternative Activation and click Next; there will be two options to choose from:
      • Activate Offline:  requires a License File.
      • Use a License manager: Floating License activation
  6. Enter your serial number to activate and install the product.
  7. Activation completed. Click Next to continue.
  8. If there is package from another update of Parallel Studio XE 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.
  9. The Installation Summary dialog box opens to show the summary of your installation options (chosen components, destination folder, etc.). Click Install to start installation (proceed to step 15) or click Customize to change settings. If you select "Customize", follow steps 10-14. Installation summary
  10. In the Architecture Selection dialog box, select the architecture of the platform where your software will run.
  11. In the Choose a Destination Folder dialog box, choose the installation directory. By default, it is C:\Program Files\Intel_sw_development_tools. You may choose a different directory. All files are installed into the Intel Parallel Studio XE 2016 subdirectory (in the case if you chose I want to install this update separate from the existing version, all files will be installed into the Composer XE 2015.0.xxx is the package number).
  12. Package contains components for integration into Microsoft Visual Studio*. You are able to select the Microsoft Visual Studio product(s) for integration on the Choose Integration target dialog box.
  13. 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).
  14. The Installation Summary dialog box opens to show the summary of your installation options (chosen components, destination folder, etc.). Click Install to start installation.
  15. Click Finish in the final screen to exit the Intel Software Setup Assistant. 

Online Installation on Windows* OS

The default electronic installation package for Intel DAAL for Windows now consists of a smaller installation package that dynamically downloads and then installs packages selected to be installed. This requires a working internet connection and potentially a proxy setting if you are behind an internet proxy. Full packages are provided alongside where you download this online install package if a working internet connection is not available.

Silent Installation on Windows* OS

Silent installation enables you to install Intel DAAL 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:

  1. Go to the folder where the Intel DAAL package was extracted during unpacking; by default, it is the C:\Program Files\Intel\Download\w_daal_2016.y.xxx folder.
  2. Run setup.exe, located in this folder: 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.

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 DAAL is not required.

Uninstalling Intel DAAL for Windows* OS

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

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

Installing Intel DAAL on Linux* OS

You can install multiple versions of Intel DAAL and any combination of 32-bit and 64-bit variations of the library on your development system.

These instructions assume you to have an Internet connection. The installation program will automatically download a serial number to your system. If you do not have an Internet connection, see the manual installation instructions below.

Interactive installation on Linux* OS

  1. If you received the product as a downloadable archive, first unpack the Intel DAAL package
    tar -zxvf name_of_downloaded_file
  2. Change the directory (cd) to the folder containing unpacked files.
  3. Run the installation script and follow the instructions in the dialog screens that are presented:
    > ./install.sh
  4. 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.

GUI installation on Linux* OS

If on a Linux* system with GUI support, the installation will provide a GUI-based installation. If a GUI is not supported (for example if running from an ssh terminal), a command-line installation will be provided.

To install Intel DAAL for Linux* OS  in GUI mode, run shell script (install_GUI.sh).
If a GUI is not supported (for example, if running from an ssh terminal), a command-line installation will be provided.

Silent Installation on Linux* OS

To run the silent install, follow these steps:

  1.  If you received the product as a downloadable archive, first unpack the Intel DAAL package
    >tar -zxvf name_of_downloaded_file
  2. Change the directory (cd) to the folder containing unpacked files.
  3. Edit the configuration file silent.cfg following the instructions in it:
    1.  Accept End User License Agreement by specifying ACCEPT_EULA=accept instead of default "decline" value;
    2. Specify activation option for the installation.
      • Default option is to use existing license (ACTIVATION_TYPE=exist_lic), please make sure that a working product license file 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 or ~/licenses.
      • To use another way of activation, change the value of ACTIVATION_TYPE variable. You may also need to change the value of ACTIVATION_SERIAL_NUMBER andACTIVATION_LICENSE_FILE variable for specific activation options.
  4. Run the silent install:
    >./install.sh --silent ./silent.cfg

Tip: You can run install interactively and record all the options into custom configuration file using the following command.
>./install.sh  --duplicate "./my_silent_config.cfg"
After this you can install the package on other machines with the same installation options using
>./install.sh --silent "./my_silent_config.cfg"

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 DAAL is not required.

Online Installation on Linux* OS

The default electronic installation package for Intel DAAL for Linux consists of a smaller installation package that dynamically downloads and then installs packages selected to be installed. This requires a working internet connection and potentially a proxy setting if you are behind an internet proxy. Full packages are provided alongside where you download this online install package if a working internet connection is not available.

Offline Installation on Linux* OS

If the system where Intel DAAL will be installed disconnected from internet, product may be installed in offline mode.
To install product offline user must provide to installer full path to license file.

License file (.lic file) is included as an attachment to email which sends after purchasing and registration product on IRC. User may request to resend .lic file from IRC. To achieve this go to "My Intel Products" page, select needed update for Intel DAAL from "Download Latest Update" column. When page with information about selected product update will be opened, click on "Manage" reference in "Licenses" column. When "Manage License" page will be opened, press button "Resend license file to my email".

  1. If product installs in GUI mode: on "Activation options" dialog select "Choose alternative activation" radio button, press "Next" button. On following dialog select "Activate offline" radio button, press "Next" button. On next dialog type full path to license file and press "Next" button.
  2. If product installs in interactive mode: on step 3 "Activation step" select point 4 - "I want to activate by using a license file, or by using Intel(R) Software". On next step choose point 1 - "Activate offline [default]" and type full path to license file.
  3. If product installs in silent mode: in the file silent.cfg set value: license_file for variable: ACTIVATION_TYPE, set full path to license file to variable: ACTIVATION_LICENSE_FILE

Uninstalling Intel DAAL for Linux* OS

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

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

Alternatively, you may use GUI mode for uninstall Intel DAAL for Linux* OS. First, run shell script install_GUI.sh, then select Remove option from menu and press "next" button.

If you installed in the default directory, use:
> /opt/intel/compilers_and_libraries_2016.x.xxx/linux/daal

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

For more complete information about compiler optimizations, see our Optimization Notice.