------------------------------------------------------------------------ Intel(R) Threading Building Blocks - Installation Guide Version 2.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 *this version* installed, you need to uninstall the existing version before installing this version. The default install location on Microsoft* Windows* systems is: C:\Program Files\Intel\TBB\ or C:\Program Files (x86)\Intel\TBB\ (Microsoft* Windows* on Intel(R) EM64T processors only) The default install location on Linux* systems is: /opt/intel/tbb/ The default install location on Mac OS* X systems is: /Library/Frameworks/TBB.framework/Versions/ To install on Microsoft* Windows* systems: 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 tbb__win.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 "Next". 3. The Intel(R) Software Setup Assistant appears. Click "Next" to continue the installation, or click the links provided on the left-hand side to view useful product and support information. 4. Choose between the following product license options: (1) Use the existing license found on the system. (2) Provide your serial number. (3) Provide a license file. 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), enter the path to a license file, and click "Next" if you are not connected to the Internet or you have a license file. If installing from CD-ROM, a default license is installed on the CD-ROM that permits installation and use of the product but does not allow upgrades/updates. If not installing from CD-ROM, a license was provided to you, when you purchased the product, in an e-mail from Intel or your reseller. Copy the license to a location on your system, choose option (3), provide the path to the license file, and click "Next". 5. The installation begins. Click "Next" to proceed. 6. Read the license agreement and click "Next" to accept it and continue. 7. Accept the default installation directory or choose a different directory. In the directory you choose, a product/version directory is created where all product files are installed. Any previous product version(s) can co-exist with this product version. Make sure to update your build scripts to point to the desired product version if you choose to keep multiple versions installed. Click "Next". 8. Select the checkbox to register the PATH, LIB and INCLUDE environment variables for the environment you wish to use, so that the product libraries and headers can be located easily when compiling and linking. Click "Install" to proceed with the installation. After the installation completes, a file named tbbvars.bat is placed in each of the "bin" sub-directories where the product software is installed. Use this file to set the PATH, LIB and INCLUDE environment variables in a user shell or to select a different environment after installing. 9. Wait for the installation to complete, and then click "Finish". 10. If you have not already registered your product, a registration screen appears. Enter your full e-mail address to register for support, free product updates, and more, or click "Cancel" to skip the registration step. If you have already registered your product, the Intel(R) Software Setup Assistant re-appears. Click the links on the left-hand side, or click "Finish" when done. To install on Linux* systems: 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 tbb__lin.tar.gz 2. Run the installation script. Execute the script in the directory where the package was unpacked in the previous step. # cd /tbb__lin # ./install.sh 3. If you are logged in as root, you may choose to install with or without using RPM, however, using RPM is strongly recommended. If you are not logged in as root, you may only install without using RPM. Enter your selection as appropriate. 4. The Intel(R) Software Setup Assistant starts. The installation script displays a series of options: 1. Install 2. Readme 3. Release Notes ... etc. Enter 1 to begin the installation, or enter another choice to view useful product and support information. 5. Choose between the following product license options: 1. Use existing license found on your system. 2. Proceed with Serial Number to install and register. 3. Provide a path to a license file. x. Exit. 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 and 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 and enter the path to a license file if you are not connected to the Internet or you have a license file. If installing from CD-ROM, a default license is installed on the CD-ROM that permits installation and use of the product but does not allow upgrades/updates. If not installing from CD-ROM, a license was provided to you, when you purchased the product, in an e-mail from Intel or your reseller. Copy the license to a location on your system, choose option (3), provide the path to the license file, and proceed. 6. The installation script then extracts the product and does some prerequisite checking. Enter 1 to proceed with the installation, or enter x to exit without installing. 7. Press to display the license agreement. Read the license agreement and enter accept to continue. 8. The installation will continue after accepting the license agreement. Enter the path to use for temporary files or press to accept the default temporary file path. Next, enter the desired install path or press to accept the default install path. In the directory you choose, a product/version directory is created where all the product files are installed. Any previous product version(s) can remain installed when installing this product version. 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, if you are not logged in as root, you will need to choose directories for which you have write access. 9. Wait for the installation to complete. After the installation completes: - The "bin" and "lib" sub-directories are created that link to the architecture/platform-specific "bin" and "lib" 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 "bin" sub-directories. Use these files to set the LIBRARY_PATH, LD_LIBRARY_PATH and CPATH environment variables in a user shell so that the product libraries and headers can be located when compiling and linking. 10. If you have not already registered your product, a registration screen appears. Enter your full e-mail address to register for support, free product updates, and more, or enter x to skip the registration step and exit the installation script. If you have already registered your product, the Intel(R) Software Setup Assistant re-appears. Enter x to exit the installation script, or enter another choice to view useful product and support information. To install on Mac OS* X systems: Note that Xcode* tool suite 2.4.1 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 tbb__mac.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 tbb__mac.dmg. 2. Open the mounted disk to view the contents. Locate the file named Install, and double-click it. 3. The Intel(R) Software Setup Assistant appears. Click "Continue" to continue the installation, or click the links provided on the left-hand side to view useful product and support information. 4. Choose between the following product license options: (1) Use the existing license found on the system. (2) Provide your serial number. (3) Provide a license file. 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), enter the path to a license file, and click "Next" if you are not connected to the Internet or you have a license file. If installing from CD-ROM, a default license is installed on the CD-ROM that permits installation and use of the product but does not allow upgrades/updates. If not installing from CD-ROM, a license was provided to you, when you purchased the product, in an e-mail from Intel or your reseller. Copy the license to a location on your system, choose option (3), provide the path to the license file, and click "Next". 5. The installation program starts. Click "Continue". 6. Read the Introduction information and click "Continue". 7. Read the license agreement and click "Continue" and "Accept". 8. Note the Volume where the destination folder for your installation will be located and click "Continue". 9. Click "Install" (or "Upgrade") to begin the installation. 10. Wait for the installation to complete, and then click "Close". After the installation completes: - The "bin" and "lib" sub-directories are created that link to the architecture/platform-specific "bin" and "lib" 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 "bin" sub-directories. Use these files to set the LIBRARY_PATH, LD_LIBRARY_PATH and CPATH environment variables in a user shell so that the product libraries and headers can be located when compiling and linking. 11. If you have not already registered your product, a registration screen appears. Enter your full e-mail address and click "Continue" to register for support, free product updates, and more, or close the window to skip the registration step. If you have already registered your product, the Intel(R) Software Setup Assistant re-appears. Click the links on the left-hand side, or click "Finish" and "Yes" when done. Uninstalling Intel(R) Threading Building Blocks ----------------------------------------------- Note: Uninstalling the product software does *not* delete the corresponding license file. Microsoft* Windows* Systems 1. Click the Windows "Start" button and select "Settings", "Control Panel", "Add or Remove Programs". 2. Click Intel(R) Threading Building Blocks to select it from the list of installed software. 3. Click "Remove" and then click "Yes" to uninstall. Linux* 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 # ./uninstall.sh 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 # ./uninstall.sh 2. An alternative to using uninstall.sh is to double-click the "uninstall" icon that is located in the installation directory. This icon has the file name uninstall.app. Known Issues ------------ Please note the following with respect to this particular release of Intel(R) Threading Building Blocks. Windows* Installation Issues - If the version of Windows* Installer on your system is older than version 2.0, the installer will automatically upgrade it and you will need to reboot the computer after the installation is complete. - 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. - When using a non-English log-in name on a Windows* system, the Intel(R) Threading Building Blocks installer may fail. The workaround is to change to an English log-in name. If you have already started the installation and encounter this issue, use Task Manager and click "End Task" for each of these processes: setup.exe, secore.exe, and sewingui.exe. Linux* 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). - When installing on Linux*, there is a known issue where the registration step at the end of the installation program may freeze after your e-mail address is entered. If this occurs, you may interrupt the installation program (e.g., via pressing ); the installation should already have completed. In this case, you may register via the Intel(R) Software Development Products Registration Center by visiting: https://registrationcenter.intel.com/ Mac OS* X Installation Issues - Xcode* tool suite 2.4.1 or higher must be installed prior to installing Intel(R) Threading Building Blocks on Mac OS* X systems. ------------------------------------------------------------------------ Copyright (C) 2005-2008 Intel Corporation. All Rights Reserved. Intel, Pentium, Intel Xeon, Itanium, Intel XScale and VTune are registered trademarks or trademarks 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.