Intel® Trace Analyzer and Collector for Linux* OS
Installation Guide

Contents

Introduction

This document explains how to install and configure the Intel® Trace Analyzer and Collector. Installation is a multi-step process. Read this document in its entirety before beginning, and follow the steps in sequence. For information about the product contents, including new and changed features, see Release Notes.

If you have a previous version of the Intel Trace Analyzer and Collector installed, you do not need to uninstall it before installing this version. If you choose to uninstall the older version, you may do so before or after installing this version.

System Requirements

The following section describes supported hardware.
 

Obtaining the Intel® Trace Analyzer and Collector

Before installing the Intel Trace Analyzer and Collector, you should check the Intel® Registration Center to see if a newer version or an update is available. The version on CD or as listed in your electronic download license letter may not be the most current.

Installing the Intel® Trace Analyzer and Collector

Installation Instructions

To install the Intel Trace Analyzer and Collector package, do the following:

  1. Upon registering for Trace Analyzer and Collector, you will receive a serial number for this product. Your serial number be found within the email receipt of your product purchase. Go to the Intel® Registration Center site and provide the product serial number information. Once admission has been granted into the registration center, you will be able to access the Intel® Premier Web pages for software support.


  2. Extract the l_itac_p_<version>.<package_num>.tar.gz package by using following commands

     

    # cp l_itac_p_<version>.<package_num>.tar.gz /tmp

    # cd /tmp

    # tar -xzf l_itac_p_<version>.<package_num>.tar.gz



  3. Place the license file for the Trace Analyzer and Collector that is provided to you in /tmp/l_itac_p_<version>.<package_num>. Do not change the file name as the ".lic" extension is critical. For instance, do the following:


    # cd l_itac_p_<version>.<package_num>

    # cp <license key>.lic .


  4. Execute the install script:


    # ./install.sh


  5. If you started installation as an ordinary user, you will be prompted for a choice:

    Which of the following would you like to do?

    Please type a selection:


    The message above will not appear if you start installation as root. Make a choice and hit the enter key.


  6. If the installer cannot find a valid license, the following dialog will appear:

     

    A valid FLEXlm license is required to install this product, but none were found in

     

    /opt/intel/licenses

     

    Where is a valid FLEXlm license for this product?


    Enter location, or press Enter to exit.


    If the license is found, but expired, the installer will report that.


  7. If you already have Intel Trace Analyzer and Collector previously installed the following message will appear:

     

    Would you like to:

    Install:

1. Intel® Trace Collector version 7.2 p<package#>

2. Intel® Trace Analyzer version 7.2 p<package#>

a. All of the above

Uninstall:

3. intel-ta-em64t version a.b.c

4. intel-tac-em64 version a.b.c

x. Exit

Please type a selection (1/2/a/3/4/x) [a]:


Make a choice and hit enter.


  1. The EULA dialog will appear:

    Intel(R) Trace Analyzer and Collector version a.b.c-xxx


    Please carefully read the following license agreement for Intel(R) Trace Analyzer and Collector version a.b.c-xxx. Prior to installing the software you will be asked to agree to the terms and conditions of the following license agreement.

    Press Enter to continue...


    --- EULA Content ---


    Do you agree to be bound by the terms and conditions of this license agreement?

    Enter 'accept' to continue, 'reject' to exit: (accept/reject):


    Enter ‘accept’ to continue.

     
  2. Enter default MPI implementation to support when prompted

Which MPI implementation would you like to be set as a default (mpich/impi4) [impi4]:
 

mpich refers to support for the ANL* MPICH* implementation
 

impi4 refers to support for the Intel® MPI Library 4.x implementation


  1. Enter installation prefix when prompted.

Please specify installation prefix [installdir/intel/itac/8.0.0.<package#>]       

Installer is about to install product at the installdir/intel/itac/8.0.0.<package#> folder

        Press Enter of you agree with this or specify another prefix:  

         

  1. The following message will appear when the installation is completed.

Installation successful.

To uninstall this package, run "installdir/intel/itac/8.0.0.<package#>/uninstall.sh".

 

  1. Make sure that there were no ERROR messages and pay attention to WARNING messages. If the installation failed, the following message will appear:

Installation failed. Please see log for details.


Installer Options

     --arch=ia32|intel64

Install components for a specified architecture

     --default-mpi=impi4|mpich

MPI implementation that will be set as the default.

     --install-path=DIR, --installpath=DIR

Install the product to specified directory

     --license-path=DIR, --licensepath=DIR

Search the specified directory for a license

     --log-file=FILE

Write log to the specified file

     --non-root, --nonroot

Do not ask for a root password

     --non-rpm, --nonrpm

Perform non-RPM installation

     --save-config=FILE, --duplicate=FILE

Save the user's responses in a FILE

     --tmp-dir=PATH

Use the specified directory for temporary files

     --use-config=FILE, --silent=FILE

Perform a silent installation by using the responses from FILE

     --without-impi

Do not install Intel(R) MPI Library specific components 

    --without-mpich

Do not install MPICH specific components   

     -?, --help

Show the help menu     

     -V, --version

Print the product version

 

Silent Installation

The ./install.sh script has a silent installation mode that helps you to install the Intel Trace Analyzer and Collector on clusters with many nodes. Edit the file SilentInstallConfigFile.ini contained in the unpacked package directory or create a new one to use this mode. See the description of the environment variables below.

    INSTALLDIR

Set the prefix of the installation directory

    LICENSEPATH

Set the full path to the product license, including the filename

    INSTALLMODE

Set the installation mode: RPM or NONRPM

    INSTALLUSER

Define the installation user permissions: ROOT or NONROOT

    INSTALL_ITA

     Install the Intel® Trace Analyzer components, Yes or NO

    INSTALL_ITC

    Install the Intel® Trace Collector component, Yes or NO

    DEFAULT_MPI

    MPI implementation that will be set as the default:impi4 or MPICH

    EULA

Set this variable to ACCEPT, if you agree to the terms and conditions listed in itacEULA.txt. Otherwise, set to REJECT.

Setting up the Environment

 

  1. Source the appropriate itacvars.[c]sh script from the Intel® Intel Trace Analyzer and Collector bin directory.
  2. If using Intel® Professional Edition Compilers, source any required *vars.[c]sh scripts.
  3. Set up additional environment variables as needed.
  4. See the Intel® Trace Analyzer and Collector Getting Started Guide for more information.

Uninstalling the Intel® Trace Analyzer and Collector

To uninstall the Intel Trace Analyzer and Collector, go to the Intel Trace Analyzer and Collector installation directory and run the uninstall.sh script.

Note: Uninstalling the Intel Trace Analyzer and Collector does not delete the corresponding license file.

Obtaining Technical Support

To receive technical support for this product, you need to be registered for an Intel® Premier Support account on our secure web site, https://premier.intel.com. Please register at http://support.intel.com/support/performancetools/support.htm and click on "Registration Center".

Note: If you have questions or problems getting started with the Intel® Analyzer and Collector, please contact support at  https://registrationcenter.intel.com/support/

For general support information please visit http://www.intel.com/software/products/support/itac or http://www.intel.com/software/products/support/


Disclaimer and Legal Information

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL(R) PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. 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.
UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR.
Intel may make changes to specifications and product descriptions at any time, without notice. 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 information here is subject to change without notice. Do not finalize a design with this information.
The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.
Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.
Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting Intel's Web Site.

Intel processor numbers are not a measure of performance. Processor numbers differentiate features within each processor family, not across different processor families. See http://www.intel.com/products/processor_number for details.

BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Atom, Centrino Atom Inside, Centrino Inside, Centrino logo, Core Inside, FlashFile, i960, InstantIP, Intel, Intel logo, Intel386, Intel486, IntelDX2, IntelDX4, IntelSX2, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, Intel Inside logo, Intel. Leap ahead., Intel. Leap ahead. logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel StrataFlash, Intel Viiv, Intel vPro, Intel XScale, Itanium, Itanium Inside, MCS, MMX, Oplus, OverDrive, PDCharm, Pentium, Pentium Inside, skoool, Sound Mark, The Journey Inside, Viiv Inside, vPro Inside, VTune, Xeon, and Xeon Inside are trademarks of Intel Corporation in the U.S. and other countries.

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