=============================================================================== Intel(R) Thread Checker 3.1 for Linux* Install Notes =============================================================================== Contents -------- 1. Introduction 2. System Requirements 3. Obtaining Intel(R) Thread Checker for Linux* 4. Installing Intel(R) Thread Checker for Linux* 5. Uninstalling Intel(R) Thread Checker for Linux* 6. Technical Support 7. Related Products Introduction ------------ This document explains how to install and configure Intel(R) Thread Checker 3.1 for Linux*. Read this document in its entirety before you begin. Follow the steps provided in sequence. The Linux Remote Data Collector (RDC) may be available for legacy usage. Contact customer support for more information. System Requirements ------------------- See Release_Notes.txt for detailed hardware and software requirements. Obtaining Intel(R) Thread Checker for Linux* ----------------------------------------------- Visit the Intel(R) Registration Center website to download the latest version of Intel(R) Thread Checker for Linux*. See the Technical Support section of Release Notes for details. Installing Intel(R) Thread Checker for Linux* ----------------------------------------------- WARNING ------- To enable full source instrumentation functionality, make sure you have successfully installed Intel(R) C++ Compiler for Linux* version 8.1 or higher, or Intel(R) Fortran Compiler for Linux* version 8.1 or higher. Detailed information regarding compatible compiler versions is listed in the Release Notes under System Requirements. 1. Unpack the package in a directory to which you have write access. Enter: # tar -xzf itt_tc_cl_3.1-.tar.gz 2. If you are logged in as root, you can choose to install with or without using RPM, however, using RPM is strongly recommended. If you are not logged in as root, you may install with RPM by supplying the root password, otherwise you may only install without using RPM. If you are not logged in as root and you wish to install with RPM, ensure that the directory you are in grants read and execute privileges to all. Additionally, execute: # chmod -R a+rx itt_tc_cl 3. Run the installation script. Execute the script in the directory where the package was unpacked in the first step. Enter: # cd itt_tc_cl # ./install.sh The Intel(R) Software Setup Assistant starts. The installation script displays a series of options: 1. Install 2. Readme 3. Release Notes 4. Installation Guide 5. Product Web Site URL 6. Intel(R) Support Web Site URL Enter 1 to begin the installation, or enter another choice to view useful product and support information. 1. Choose between the following product license options: 1. Proceed with a Serial Number to install and register.[Recommended] 2. Provide the absolute path for an existing license file. x. Exit. If you are connected to the Internet and you have a serial number, enter 1 and enter a serial number when prompted. 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. If you are not connected to the Internet or you have a license file, enter 2 and enter the path to 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 (2), provide the path to the license file, and click "Next". The installation script extracts the product and does some prerequisite checking. Press Enter to display the license agreement. Read the license agreement and enter "accept" to continue. The installation will continue after accepting the license agreement. Wait for the installation to complete. - Files named tcheckvars.sh and tcheckvars.csh are placed in the "bin" sub-directories. You can use these files to set the LIBRARY_PATH, LD_LIBRARY_PATH and PATH environment variables in a user shell so that the product libraries and headers can be located when compiling and linking. The Intel(R) Software Setup Assistant re-appears. Choose other options or "x" to finish. Silent Installation Mode ------------------------ Intel(R) Thread Checker for Linux* also has a silent installation mode if you are logged in as root. To use this mode,you will need to edit file tc_silent_config.ini in directory itt_tc_cl/data. Change the line stating EULA=reject to EULA=accept. Other lines in the file enable you to define the following parameters TC_DESTINATION, INSTALLMODE, INTEL_LICENSE_FILE, CONTINUE_WITH_NONSUPPORT_OS, ALLOW_UPGRADE_TC, ALLOW_DEGRADE_TC After editing the tc_silent_config.ini file, execute the script in the same directory to install in silent mode. # install-tc.sh --silent tc_silent_config.ini Uninstalling Intel(R) Thread Checker for Linux* -------------------------------------------------- To uninstall: ------------- 2. Change to the installation directory. The default installation directory is "/opt/intel/itt". 3. Execute the uninstall script, for example: On Linux* 32-bit: # ./uninstall32.sh On Linux* 64-bit on Intel(R) EM64T processors: # ./uninstall32e.sh On Linux* 64-bit on Itanium(R) processors: # ./uninstall64.sh Technical Support ----------------- The product support web site( http://support.intel.com/support/performancetools/threadchecker/ ) contains frequently asked questions, product documentation, product errata, as well as solutions to common issues. To receive technical support for this product or product updates, you need to register for an Intel(R) Premier Support account at the Intel(R) Registration Center (http://www.intel.com/software/products/registrationcenter/ ). When submitting an issue to Intel(R) Premier Support ( https://premier.intel.com/), be sure to select Intel(R) Thread Checker for Linux* from the Product Name drop down list. When submitting an issue please provide the product build number. This information can be found in the tcSupport.txt file. This file is located on the Linux* system in the directory where Intel(R) Thread Checker for Linux* was installed. The default installation directory is "/opt/intel/itt". Please include the corresponding build number from the tcSupport.txt. This file is located on the Linux* system in the directory where Intel(R) Thread Checker for Linux* was installed. The default installation directory is "/opt/intel/itt". Once you have contacted us with your suggestion or problem using your Premier Support account, a technical support engineer will respond within one Intel business day. If you have not received or have lost your Premier Support login ID or password, or are having trouble with access, please visit https://registrationcenter.intel.com/support for assistance. Related Products and Services ----------------------------- Information about Intel(R) Software Development Products is available at http://www.intel.com/software/products. Some of the related products include: - Intel(R) Thread Profiler is a performance tuning tool for parallel programs that use Win32*, POSIX*, OpenMP* or custom synchronization. ( http://www.intel.com/software/products/threading ) - VTune(TM) Performance Analyzer enables you to evaluate how your application is utilizing the CPU and helps you determine if there are modifications you can make to improve your application's performance. ( http://www.intel.com/software/products/vtune ) - Intel(R) Compilers are an important part of making software run at top speeds with full support for the latest Pentium(R) and Itanium(R) processors. ( http://www.intel.com/software/products/compilers ) - Intel(R) Cluster Tools can help developers create, analyze and optimize high-performance applications on clusters of Intel(R) processor-based systems. ( http://www.intel.com/software/products/cluster ) - Intel(R) Performance Library Suite provides a set of routines optimized for various Intel processors. ( http://www.intel.com/software/products/perflib ) - Intel(R) Software College provides training for developers on leading-edge software development technologies. Training consists of online and instructor-led courses covering all Intel architectures, platforms, tools, and technologies. ( http://www.intel.com/software/college ) Disclaimer and Legal Information -------------------------------- The information in this document is subject to change without notice and Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. This document and the software described in it are furnished under license and may only be used or copied in accordance with the terms of the license. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. The information in this document is provided in connection with Intel products and should not be construed as a commitment by Intel Corporation. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The software described in this document may contain software defects which may cause the product to deviate from published specifications. Current characterized software defects are available on request. Intel, the Intel logo, Intel SpeedStep, Intel NetBurst, Intel NetStructure, MMX, i386, i486, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2,Celeron, Intel Centrino, Intel Xeon, Intel XScale, Itanium, Pentium, Pentium II Xeon, Pentium III Xeon, Pentium M, and VTune are trademarks or registered 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. Copyright (c) Intel Corporation 2007.