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 the 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.
  Systems based on the Intel® 64 architecture:

Obtaining Intel® Trace Analyzer and Collector

Before installing the Intel Trace Analyzer and Collector, you should check the Intel® Software Development Products 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 Intel® Trace Analyzer and Collector

Installation Instructions

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

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

  2. Extract the l_itac_p_<version>.<package_num>.tgz package using the following commands:

    # cp l_itac_p_<version>.<package_num>.tgz /tmp

    # cd /tmp

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

  3. Place the license file for the Intel 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 .

    You can set a public key file to validate the digital signature of the Red Hat* Package Manager (RPM) packages. The PUBLIC_KEY.PUB key is included in the package. If you do not include the PUBLIC_KEY.PUB argument in the command line, it is necessary to have active internet connection to automatically download the public key from the Intel® Reseller Center website.

  4. Execute the install script:

    # ./install.sh

  5. If you started installation as an ordinary user, you will be prompted for a choice. Make a choice and hit the enter key.

    Please make your selection by entering an option.

    Root access is recommended for evaluation.

     

    1. Run as a root for system wide access for all users [default]

    2. Run using sudo privileges and password for system wide access for all users

    3. Run as current user to limit access to user level

     

    h. Help

    q. Quit

     

    Please type a selection [1]:

    If you start installation as root, the message above does not appear.


  6. The Welcome dialog box appears:

     

    Step 1 of 7 | Welcome

    ----------------------------------------------------------------------------------

    Welcome to the Intel® Trace Analyzer and Collector 9.0 for Linux* OS

    installation program.

    ----------------------------------------------------------------------------------

    You will complete the steps below during this installation:

    Step 1 : Welcome

    Step 2 : License agreement

    Step 3 : Activation

    Step 4 : Intel® Software Improvement Program

    Step 5 : Options

    Step 6 : Installation

    Step 7 : Complete

    --------------------------------------------------------------------------------

    Press "Enter" key to continue or "q" to quit:


  7. The End User License Agreement dialog box appears:


    --------------------------------------------------------------------------------

    Step 2 of 7 | License agreement

    --------------------------------------------------------------------------------

    As noted in the Intel® Software Development Products End User License

    Agreement, the Intel® Software Development Products you install will send Intel

    the product serial number and other system information to help Intel improve

    the product and validate license compliance. No personal information will be

    transmitted.

    --------------------------------------------------------------------------------

    To continue with the installation of this product you are required to accept

    the terms and conditions of the End User License Agreement (EULA). The EULA

    is displayed using the "more" utility. Press the spacebar to advance to the

    next page or enter "q" to skip to the end. After reading the EULA, you must

    enter "accept" to continue the installation or "decline" to return to the

    previous menu.

    --More--[Press space to continue, 'q' to quit.]

  1. Select the activation method you want to use:
     

    Step 3 of 7 | Activation

    --------------------------------------------------------------------------------

    If you have purchased this product and have the serial number and a connection

    to the internet you can choose to activate the product at this time. Activation

    is a secure and anonymous one-time process that verifies your software licensing

    rights to use the product. Alternatively, you can choose to evaluate a product

    or defer activation by choosing the evaluate option. Evaluation software will

    time out in about one month. Also you can use license file or Intel® Software

    License Manager.

    --------------------------------------------------------------------------------

    1. I want to activate my product using a serial number [default]

    2. I want to evaluate my product or activate later

    3. I want to activate by using a license file, or by using a Intel® Software

    License Manager

     

    h. Help

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice [1]:

     
  2. Assuming you select option 2 as the activation method, Alternative activation  dialog appears :

     

    Step 3 of 7 | Activation options > Alternative activation

    --------------------------------------------------------------------------------

    Your license file is available for download from

    https://registrationcenter.intel.com. Further instructions are available at

    http://software.intel.com/en-rus/articles/offline-activation-of-intel-software-de

    velopment-products.

    The Intel® Software License Manager User's Guide explains how to download,

    install, configure and troubleshoot the Intel® Software License Manager. The

    guide is available at:

    http://software.intel.com/en-rus/articles/license-manager-for-flexlm-users-guide.

    --------------------------------------------------------------------------------

    1. Activate offline

    2. Use Intel® Software License Manager

     

    h. Help

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice:

  1. If you select to activate offline, you are prompted for the license file location. Provide a directory path to where the license file resides or full license file name.
  1. Intel® Software Improvement dialog box appears:

    Step 4 of 7 | Intel® Software Improvement Program

    --------------------------------------------------------------------------------

    Help improve your experience with Intel® software.

    Participate in the design of future Intel software. Select 'Yes' to give us

    permission to learn about how you use your Intel software and we will do the

    rest.

      - No personally identifiable information is collected

      - There are no additional follow-up emails by opting in

      - You can stop participating at any time

     

      Learn more about the Intel® Software Improvement Program

    http://software.intel.com/en-rus/articles/software-improvement-program

     

    With your permission, Intel may automatically receive anonymous information

    about how you use your current and future Intel® Software Development

    Products.

    --------------------------------------------------------------------------------

    1. Yes, I am willing to participate and improve Intel software. (Recommended)

    2. No, I don't want to participate in the Intel® Software Improvement Program

    at this time.

     

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection:

  1. Options dialog box appears:

    Step 5 of 7 | Options

    --------------------------------------------------------------------------------

    This product can be installed on cluster nodes.

    --------------------------------------------------------------------------------

    1. Finish configuring cluster [default]

     

    2. Configuration type          [Current node]

     

    h. Help

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice [1]:

    In this dialog box, select option 1 to start installation immediately. Select option 2 to install the product on cluster compute nodes. By default, it is installed only on the head node.
  1. After activation, you will see the Pre-install Summary dialog box:

    Step 5 of 7 | Options > Pre-install Summary

    --------------------------------------------------------------------------------

    Install location:

       /opt/intel/itac/<version>.<package_num>

       

    Component(s) selected:

    Intel® Trace Analyzer and Collector 9.0                         297MB

     Intel® Trace Analyzer for Intel® 64 Architecture

     Intel® Trace Collector for Intel® 64 Architecture

     Intel® Trace Collector for Intel® Many Integrated Core Architecture

    Install Space Required: 297MB

    Cluster installation type:

     Product will be installed on a single node

    1. Start Installation Now [default]

    2. Customize installation

    h. Help

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice [1]:

  1. If you choose to customize installation, Options dialog box appears:

     

    Step 5 of 7 | Options

    --------------------------------------------------------------------------------

    You are now ready to begin installation. You can use all default installation

    settings by simply choosing the "Start installation Now" option or you can

    customize these settings by selecting any of the change options given below

    the first. You can view a summary of the settings by selecting

    "Show pre-install summary".

    --------------------------------------------------------------------------------

    1. Start installation Now

     

    2. Change install directory      [ /opt/intel/itac/<version>.<package_num> ]

    3. Change components to install  [ All ]

    4. Show pre-install summary

     

    h. Help

    b. Back to the previous menu

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice [1]:

  1. After you choose the necessary installation type, installation process begins. When the installation is completed, press "Enter" to continue.
  1. When the installation is completed, Complete dialog box appears:

     

    Step 7 of 7 | Complete

    --------------------------------------------------------------------------------

    Thank you for installing and for using the Intel® Trace Analyzer and Collector 9.0

    for Linux* OS.

     

    Support services start from the time you install or activate your product.

    If you have not already done so, please create your support account now to

    take full advantage of your product purchase.

     

    Your support account gives you access to free product updates and upgrades

    as well as interactive technical support at Intel® Premier Customer Support.

     

    To create your support account, please visit the Intel® Software Development

    Products Registration Center web site

    https://registrationcenter.intel.com/RegCenter/registerexpress.aspx?media=939

    --------------------------------------------------------------------------------

    q. Quit

    --------------------------------------------------------------------------------

    Please type a selection or press "Enter" to accept default choice [q]:


Installer Options

     -h, --help

Print help message

     -v, --version

Print version information

     -s, --silent [FILE]

Run install silently, with settings in configuration file

     -d, --duplicate [FILE]

Run install interactively, record the user input into the configuration file

     -t, --tmp-dir [FOLDER]

Set custom temporary folder     

     -l, --lang

Set user interface language

     --cli-mode

Run install in command-line mode

     --gui-mode

Run install in graphical mode

     --user-mode

Run install with current user privileges

     --ignore-cpu

Skip CPU model check

     --nonrpm-db-dir

Set directory to store product installation database

     --SHARED-INSTALL

Install to a network-mounted drive or shared file system for multiple users

     --signature PUBLIC_KEY.PUB

Set public key file to validate digital signature of the Red Hat* Package Manager (RPM) packages. The PUBLIC_KEY.PUB key is included in the package.

     --ignore-signature

Skip signature validation

 

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 silent.cfg file contained in the unpacked package directory or create a new one to use this mode. See the description of the environment variables below.

    PSET_INSTALL_DIR

Set the prefix of the installation directory

    ACTIVATION

Activation type. Possible values:

    PSET_LICENSE_FILE

Set the full path to the product license, including the filename. Applicable if ACTIVATION=license_file.

    INSTALL_MODE

Set the installation mode: RPM or NONRPM

    CONTINUE_WITH_INSTALLDIR_OVERWRITE

    CONTINUE_WITH_OPTIONAL_ERROR

    Ignore warning messages (yes|no)

    ACCEPT_EULA

Set this variable to accept, if you agree to the terms and conditions listed in license.txt. Otherwise, set to decline.

Installation in Graphical User Interface Mode

There is a prerequisite: X-server should be up and running.

Follow these steps to install the Intel Trace Analyzer and Collector in the GUI mode:

  1. Invoke the Graphical User Interface installation by entering the following command:

    ./install.sh --gui-mode

  2. In the User Selection dialog box, select the corresponding option to indicate that you want to install as a root, install as a root using sudo command, or install as a current user. Click Next to continue.
  3. The Welcome dialog box appears. Click Next to continue.
  4. In the EULA dialog box, read and accept the terms of the End User License Agreement.
  5. You may be asked to select an activation type. Select the preferred type and provide additional information (serial number or license file). Click Next to continue.
  6. Assuming you select alternative activation, the Alternative activation dialog box appears. In this dialog box, you can choose whether to use license file or Intel® Software License Manager.
  7. The Intel® Software Improvement Program dialog box appears. With your permission, Intel may automatically receive anonymous information about how you use your current and future Intel® Software Development Products. Select 'Yes' to give us permission to learn about how you use your Intel software and we will do the rest. Note that no personally identifiable information is collected, you do not receive any additional follow-up emails when opted in, and you can stop participating at any time. You can learn more about the Intel® Software Improvement Program at http://software.intel.com/en-us/articles/software-improvement-program.
  8. The Installation Summary dialog box appears. Press the Customize Installation button to specify the install directory, select the components you want to install, and enable installation on cluster nodes.

    Click Next to start installation.

  9. Click Finish to complete the installation.

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 Page for more information.

Uninstalling 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.

To uninstall the Intel Trace Analyzer and Collector in the GUI mode, enter the following command:

./uninstall.sh --gui-mode

In the graphical user interface, take these steps to uninstall the Intel Trace Analyzer and Collector:

  1. Select the user type in the User Selection dialog box. Click Next to continue.
  2. The Welcome dialog box appears. Click Next to continue.
  3. In the Options dialog box, specify whether you want to uninstall the Intel Trace Analyzer and Collector from the current node, or from the whole cluster. Click Next to continue.
  4. The Uninstall Summary dialog box appears. Click the Uninstall button to uninstall the Intel Trace Analyzer and Collector.
  5. When the Intel Trace Analyzer and Collector is uninstalled, the Complete dialog box appears.

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 Customer Support account on our secure web site, https://premier.intel.com. Register your product in the Intel® Software Development Products Registration Center at https://registrationcenter.intel.com/

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

For general support information please visit http://software.intel.com/en-us/intel-trace-analyzer/ or http://software.intel.com/en-us/support/

Disclaimer and Legal Information

No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.

Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.

This document contains information on products, services and/or processes in development. All information provided here is subject to change without notice. Contact your Intel representative to obtain the latest forecast, schedule, specifications and roadmaps.

The products and services described may contain defects or errors known as errata which may cause deviations from published specifications. Current characterized errata are available on request.

Intel, Intel Core, Xeon and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

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

© 2015 Intel Corporation.