------------------------------------------------------------------------ Intel(R) Threading Building Blocks - Installation Guide Version 4.3 ------------------------------------------------------------------------ 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\\tbb or C:\Program Files (x86)\Intel\\tbb (64-bit versions of Microsoft* Windows OS* only) The default install location on Linux OS* is: /opt/intel//tbb or /intel//tbb (If you are not logged in as root) The default install location on OS X* systems is: /opt/intel//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 .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_..exe. 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". The installation program starts. Click "Next". 2. 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. 3. Choose between the following product license options: (1) Use the existing license found on the system. (2) Provide your serial number. (3) Evaluate this product. (4) Choose alternative activation (4.1) Activate offline (4.2) 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. Choose option (3) if you want to evaluate the product or activate at a later time, then click "Next" d. Select option (4), if you have a license file provided to you after registration of your serial number, then select option (4.1). Use a license file, enter the path to a license file, and click "Next". 4. Read Intel(R) Software Improvement Program details and decide if you want to participate in the Program or not, then click "Next". 5. 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. 6. Click "Customize" for Custom installation (for advanced users) or "Next" to install the product with default settings (recommended). 7. To start installation click "Install". After the installation completes, a file named tbbvars.bat is placed in the "...\\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 # tar -xzf l_tbb_..tgz 2. Run the installation script. Execute the script in the directory where the package was unpacked in the previous step. # cd /l_tbb_. # ./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 Step 4 : Options Step 5 : Installation Step 6 : 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 by using a license file, or by using Intel(R) Software 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 1 and type the path to a license file if you have a license file provided to you after registration of your serial number. 7. Pre-install summary is displayed. Enter 2 to customize the installation. Enter 1 to start the installation. 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. Wait for the installation to complete. To create your support account, visit the Intel(R) Software Development Products Registration Center web site by link provided. Enter "q" to exit the installation script. After the installation completes: - The "lib" sub-directory is created with 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 OS X* systems: Note that Xcode* tool suite 5.0 or higher must be installed prior to installing Intel(R) Threading Building Blocks on 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_..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_..dmg. 2. Open the mounted disk to view the contents. Locate the file named m_tbb_..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) Evaluate this product. (4) Alternative 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) if you want to evaluate the product or activate it later. d. Choose option (4), if you have a license file provided to you after registration of your serial number, then option (1) "I want to use a license file to activate my software", and specify the location of the license file. 6. Specify Xcode install directory if required and press "Continue". 7. Read Intel(R) Software Improvement Program details and decide if you want to participate in the Program or not, then click "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. Optionally, click the "Create My Support Account" button to create your support account to access free product updates and upgrades. 11. Click "Continue" and then "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) Parallel Studio XE 2015 Composer Edition 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, then 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/. # ./uninstall.sh 2. Select the component Intel(R) Threading Building Blocks and start uninstalling it. 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/. # ./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). OS X* Installation Issues - Xcode* tool suite 3.1.2 or higher must be installed prior to installing Intel(R) Threading Building Blocks on OS X* systems. ------------------------------------------------------------------------ Copyright (C) 2005-2014 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.