------------------------------------------------------------------------
Intel(R) Threading Building Blocks - Installation Guide
            Version 4.1
------------------------------------------------------------------------


Introduction
------------

This document explains how to install and configure Intel(R) Threading
Building Blocks.  Installation is a multi-step process.  You should read
this document in its entirety before you begin.  Follow the steps
provided in sequence.


Installing Intel(R) Threading Building Blocks
---------------------------------------------

The installation software installs the full set of Intel(R) Threading
Building Blocks files for your platform, for all supported operating
systems and processors.

Previous versions of Intel(R) Threading Building Blocks can co-exist
with this version.  However, if you are installing an update on a system
that has another release of *this version* installed, then during 
the installation you will be asked to uninstall the existing release 
before installing the update, except if you use non-RPM installation
on Linux OS*.

The default install location on Microsoft* Windows OS* is:

    C:\Program Files\Intel\<Composer XE directory>\tbb
            or
    C:\Program Files (x86)\Intel\<Composer XE directory>\tbb
        (64-bit versions of Microsoft* Windows OS* only)

The default install location on Linux OS* is:

    /opt/intel/<Composer XE directory>/tbb
            or
    <home_dir>/intel/<Composer XE directory>/tbb
        (If you are not logged in as root)

The default install location on Mac OS* X systems is:

    /opt/intel/<Composer XE directory>/tbb

By default, updates of a given version will replace the existing directory
contents. When the first update is installed, the user is given the option
of having the new update installed alongside the previous installation, 
or keeping both on the system. If you keep both on the system, the 
top-level folder name for the older update changes to 
<Composer XE directory>.nnn where nnn is the update number.

To install on Microsoft* Windows OS*:

    1.  Start the installation program.

    a.  If you received the product on CD-ROM, insert the CD-ROM
        into a CD-ROM drive.  If the installation program does not
        automatically start, locate the file Setup.exe on the CD-ROM
        and double-click it.

    b.  If you received the product as an electronic download,
        double-click the downloaded file, named
        w_tbb_<version>.<package#>.exe.

    The installation program starts.  Click "Next".

    2.  At the prompt, accept the default temporary directory or choose
    a different temporary directory into which the contents of the
    self-extracting installation file will be placed before actual
    installation begins. Click "Extract".

    3.  The Intel(R) TBB installation wizard appears.  Click "Next" to
    continue the installation, or click the link provided on the
    left-hand side to view useful product and support information.

    4.  Read the license agreement and decide if you accept it or not.
    If you accept the agreement, click "Next" to proceed.  If you 
    choose not to accept it, click "Cancel" to stop the installation.
    
    5.  Choose between the following product license options:

        (1) Use the existing license found on the system.
        (2) Provide your serial number.
        (3) Choose alternative activation
            (3.1) Use remote activation
            (3.2) Use a license file
            (3.3) Use a license manager
            
    A recommended option is indicated, and options that are not
    applicable are not displayed.

    a.  Choose option (1) and click "Next" if an existing license is
        already available on your system.

    b.  Choose option (2), enter a serial number, and click "Next"
        if you are connected to the Internet and you have a serial
        number.

        A serial number was provided to you when you purchased the
        product, either in an e-mail from Intel or your reseller, or
        on a sticker attached to the CD-ROM package.  The correct
        license, based on the serial number, will automatically be
        downloaded and installed on your system.

    c.  Select option (3), then select option (3.2) Use a license file,
        enter the path to a license file, and click "Next" if you have
        a license file provided to you after registration of your 
        serial number.

    6.  Choose type of installation and click "Next" to proceed.
            (1) Full installation (recommended)
            (2) Custom installation (for advanced users)
    
    7.  To start installation click "Install".

    After the installation completes, a file named tbbvars.bat is
    placed in the "...\<Composer XE directory>\tbb\bin" directory. 
    Use this file to set the PATH, LIB and INCLUDE environment 
    variables in a user shell or to select a different installing.

    8.  Wait for the installation to complete, and then click "Finish".
    Click the link that appears to access user forums, the Intel(R) TBB
    Knowledge Base and product updates, or click "Finish" when done.

To install on Linux OS*:

    In the following instructions, specific examples of commands for
    various steps are prefixed with '#' characters.

    1.  Unpack the package in a directory to which you have write
    access.

        # cd <directory>
        # tar -xzf l_tbb_<version>.<package#>.tgz

    2.  Run the installation script.  Execute the script in the
    directory where the package was unpacked in the previous step.

        # cd <directory>/l_tbb_<version>.<package#>
        # ./install.sh

    3.  If you are logged in as root, the installation will proceed 
    automatically; otherwise you will be asked to choose whether 
    you want to run installation under root account (root password 
    required) or as current user. When running under root account,
    the installation will automatically use RPM if available on your
    system. When not under root account, you may only install 
    without using RPM.

    4.  The Intel(R) TBB installation wizard starts.  The installation
    script displays the welcome dialog, listing the installation steps:

        Step 1 : Welcome
        Step 2 : License Agreement
        Step 3 : Activation Options
        Step 4 : Installation Options
        Step 5 : Installation
        Step 6 : Installation Complete
    
    Press "Enter" key to continue or "q" to quit

    5.  Press "Enter" to display the license agreement.  Read the
    license agreement and enter "accept" to continue or "decline" to 
    return to the previous menu.

    6.  If you have agreed with the license then you should choose 
    between the following product license options:

        1. Use existing license [default]
        2. I want to activate my product using a serial number
        3. I want to evaluate my product or activate later
        4. I want to activate either remotely, or by using a license
           file, or by using a license manager

    A recommended option is indicated, and options that are not
    applicable are not displayed.

    a.  Enter 1 if an existing license is already available 
        on your system.

    b.  Enter 2, then enter a serial number if you are connected to
        the Internet and you have a serial number.

        A serial number was provided to you when you purchased the
        product, either in an e-mail from Intel or your reseller, or
        on a sticker attached to the CD-ROM package.  The correct
        license, based on the serial number, will automatically be
        downloaded and installed on your system.

    c.  Enter 3, if you want to evaluate the product or activate it later.
    
    d.  Enter 4, then enter 2 and type the path to a license file if 
        you have a license file provided to you after registration 
        of your serial number.
        
    7.  Enter 1 to proceed with the installation, enter 2 to change 
    default install directory or enter 3 to see a pre-install summary.
    If you pressed 1 then installation will be started.

    Enter the desired install path or press "Enter" to accept
    the default install path.  All the product files are installed 
    in the directory you choose.  Any previous product version(s) can 
    remain installed if this product version is installed into 
    a separate directory.  Make sure to update your build scripts 
    to point to the desired product version if you choose to keep 
    multiple versions installed.

    In each case you need to choose directories for which you have 
    write access.

    8.  Press "Enter" to display the final dialog about completed
    installation. To create your support account, visit the 
    Subscription Services web site by link provided. Press "Enter"
    to exit the installation script.
        
    After the installation completes:

    - The "bin" and "lib" sub-directories are created that contain 
        the architecture/platform-specific sub-directories for the 
        architecture and platform on which the product software was 
        installed.

    - Files named tbbvars.sh and tbbvars.csh are placed in the
        "tbb/bin" sub-directories.  Use these files with the appropriate
        arguments, or directly use files from "bin/{architecture}" 
        sub-directories to set the LIBRARY_PATH, LD_LIBRARY_PATH, 
        DYLD_LIBRARY_PATH and CPATH environment variables in a user 
        shell so that the product libraries and headers can be
        located when compiling and linking.

To install on Mac OS* X systems:

    Note that Xcode* tool suite 3.2.5 or higher must be installed
    prior to installing Intel(R) Threading Building Blocks on Mac OS* X
    systems (see also Release_Notes.txt).

    1.  Start the installation program.

    a.  If you received the product on CD-ROM, insert the CD-ROM
        into a CD-ROM drive.   Locate the file
        m_tbb_<version>.<package#>.dmg on the CD-ROM and double-
        click it.

    b.  If you received the product as an electronic download,
        double-click the downloaded file, named
        m_tbb_<version>.<package#>.dmg.

    2.  Open the mounted disk to view the contents.  Locate the file
    named m_tbb_<version>.<package#>.mpkg, and double-click it.

    3.  The Intel(R) TBB installation wizard appears.  Click "Continue"
    to continue the installation.

    4.  Read the license agreement and click "Continue". Click 
    "Agree" to continue, or "Disagree" to stop the installation.

    5.  Choose between the following product license options:

        (1) Use the existing license found on the system.
        (2) Provide your serial number.
        (3) Advanced activation options with ability to provide 
            a license file.

    A recommended option is indicated, and options that are not
    applicable are not displayed.

    a.  Choose option (1) and click "Continue" if an existing license 
        is already available on your system.

    b.  Choose option (2), enter a serial number, and click "Continue"
        if you are connected to the Internet and you have a serial
        number.

        A serial number was provided to you when you purchased the
        product, either in an e-mail from Intel or your reseller, or
        on a sticker attached to the CD-ROM package.  The correct
        license, based on the serial number, will automatically be
        downloaded and installed on your system.

    c.  Choose option (3), then option (2) "I want to enter the path to 
        a license file ...", and specify the location of a license file.

    6.  Choose the suitable install environment and then click "Continue"
    button to proceed with the installation.
    
    7.  If you chosen Xcode integration then you should specify Xcode 
    install directory and press "Continue".
    
    8.  Select the disk where you want to install library and press
    "Continue".
    
    9.  Click "Install" to perform a standard installation. Enter 
    administrator password and press "Ok".

    10.  Create your support account to access free product updates and
    upgrades if needed by clicking button appeared in the dialog. If it 
    is not needed - press "Continue".

    11.  Click "Close" button to finish installation.

    After the installation completes:
    - Files named tbbvars.sh and tbbvars.csh are placed in the "tbb/bin" 
        sub-directories.  Use these files to set the LIBRARY_PATH, 
        DYLD_LIBRARY_PATH and CPATH environment variables in a user 
        shell so that the product libraries and headers can be 
        located when compiling and linking.
        
Uninstalling Intel(R) Threading Building Blocks
-----------------------------------------------

Note: Uninstalling the product software does *not* delete the
corresponding license file.

Microsoft* Windows OS*

    1.  Click the "Start" button and select "Settings",
    "Control Panel", "Add or Remove Programs".

    2.  Click Intel(R) Composer XE 2013 for Windows to select it from
    the list of installed software.

    3.  Select the Modify option and click "Next".
    
    4.  Find Intel(R) Threading Building Blocks component and click on it.
    Choose "This will not be installed or removed" and press "Next"
    
    5. Click "Modify" to apply your changes with removing library.
    
    6. Click "Finish" to complete with uninstalling.

Linux OS*

    In the following instructions, specific examples of commands for
    various steps are prefixed with '#' characters.

    1.  Run the uninstallation script.  Execute the script in the
    "bin" sub-directory where the package was installed.

        # cd ../intel/<Composer XE directory>.<package#>/bin
        # ./uninstall.sh
    2.  Select the component Intel(R) Threading Building Blocks and start
    uninstalling it.
    
Mac OS* X Systems

    In the following instructions, specific examples of commands for
    various steps are prefixed with '#' characters.

    1.  Run the uninstallation script.  Execute the script in the
    directory where the package was installed.

        # cd ../intel/<Composer XE directory>.<package#>
        # ./uninstall_ccompxe.sh
    2.  Enter the root password and choose "y" to remove the library.

Known Issues
------------

Please note the following with respect to this particular release of
Intel(R) Threading Building Blocks.

Windows OS* Installation Issues

    - Scripts are used in the normal install process and may trip
    false positives in certain antivirus software.  You may need to
    disable script blocking or you may be able to temporarily allow
    scripts for the installation process.

Linux OS* Installation Issues

    - Some versions of RPM do not allow installation to a non-default
    installation directory, including RPM 4.0.2 (resolved in RPM
    4.0.3) and RPM 4.1 (resolved in RPM 4.11 to 4.2).

Mac OS* X Installation Issues

    - Xcode* tool suite 3.1.2 or higher must be installed prior to
    installing Intel(R) Threading Building Blocks on Mac OS* X
    systems.

------------------------------------------------------------------------
Copyright (C) 2005-2013 Intel Corporation.  All Rights Reserved.

Intel is a registered trademark or trademark of Intel Corporation
or its subsidiaries in the United States and other countries.

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