Intel® Advisor User Guide

User Guide

Contents

Set Up Environment Variables

Use this topic to get guidance on setting up environment variables for
Intel® Advisor
.
Set the environment variables if you want to:
  • Run
    Intel Advisor
     command line interface
  • Run
    Intel Advisor
     graphical user interface from command line (for example, on Linux OS)
  • Compile your application with
    Intel Advisor
     annotations
     using additional include directories, so the compiler can find the include file that defines annotations
You can set the variables using
one
 of the following methods:
  • Recommended: Set up variables using a script.
  • Set up variables manually. Use this method to set up variables for a custom
    Intel Advisor
     location or to set the variables permanently.

Default Installation Paths

In the instructions below, be sure to replace any values in brackets, such as
<version>
 or
<install-dir>
.
<version>
 is the
Intel Advisor
 year and update version (for example,
2021.1
).The default installation path for the application,
<install-dir>
, can be one the following:
  • On
    Linux* OS
    :
    • /opt/intel/oneapi
       for root users
    • $HOME/intel/oneapi
       for non-root users
  • On
    Windows* OS
    :
    C:\Program Files (x86)\Intel\oneAPI
    For 32-bit systems, the
    Program Files (x86)
     folder is
    Program Files
    .
  • On
    macOS*
    :
    /opt/intel/oneapi

Set Up Environment Variables via Script

This is the recommended method to set up the
Intel Advisor
 environment variables. In particular, use it if you want to run the Offload Modeling using the dedicated Python* scripts. The script automatically sets up all the required variables pointing to the
Intel Advisor
 installation directory.
Linux OS and macOS
Run
one
 of the following shell scripts:
source <install-dir>/setvars.sh
source <install-dir>/setvars.csh
The scripts set up the environment for the
latest
Intel Advisor
 version installed on your system.
If you want to set up environment for a lower version of the
Intel Advisor
 installed on your system, also run one of the following
Intel Advisor
-specific scripts:
source <install-dir>/advisor/<version>/env/vars.sh
source <install-dir>/advisor/<version>/env/vars.csh
where
<version>
 is the
Intel Advisor
 version you want to use.
Windows OS
Run the following batch script:
<install-dir>\setvars.bat
The script sets up the environment for the latest
Intel Advisor
 version installed on your system.
If you want to set up environment for a lower version of the
Intel Advisor
 installed on your system, also run one of the following
Intel Advisor
-specific scripts:
source <install-dir>/advisor/<version>/env/vars.sh
source <install-dir>/advisor/<version>/env/vars.csh
where
<version>
 is the
Intel Advisor
 version you want to use.

Set Up Environment Variables Manually

Linux OS and macOS
  1. Open a terminal.
  2. Check the current definition of the environment variable. For example, with the
    bash
     shell, type:
    env | grep ADVISOR_<version-year>_DIR
    where
    <version-year
    > is a major
    Intel Advisor
     version installed on your system. For example, 2021.
    If the variable is defined and points to the correct Intel Advisor installation directory, skip the steps below and continue to launch the
    Intel Advisor
    .
  3. Set the environment variable using the
    export
     command. Enter:
    export ADVISOR_<version-year>_DIR="<install-dir>"
    For example, for the Intel Advisor 2021 in the default installation directory: 
    export ADVISOR_2021_DIR="/opt/intel/oneapi/advisor/latest"
  4. To set this variable permanently on the current system, add this definition to your
    .login
     or a similar shell initialization file.
  5. Check the definition of the environment variable set:
    env | grep ADVISOR_<version-year>_DIR
    You should see the environment variable with its value printed to the terminal.
Windows OS
  1. Open a command prompt.
  2. Check the current definition of the environment variable. For example, type:
    set ADVISOR_<version-year>_DIR
    where
    <version-year
    > is a major
    Intel Advisor
     version installed on your system. For example, 2021.
    If the variable is defined and points to the correct Intel Advisor installation directory, skip the steps below and continue to launch the
    Intel Advisor
    .
  3. Use a
    set
     command to set the environment variable. Type:
    set ADVISOR_<version-year>_DIR="<install-dir>"
    For example, for the Intel Advisor 2021: 
    set ADVISOR_2021_DIR="C:\Program Files (x86)\Intel\oneAPI\advisor\latest"
  4. To set this variable permanently on the current system, add this definition to your system or user environment variables using
    Control Panel
    System and Security
    System
    Advanced system settings
    Environment Variables...
    .

Additional Variables

Consider setting the following environment variables:
  • To determine whether evaluation features have been activated, set the
    ADVISOR_EXPERIMENTAL
     environment variable.
  • To locate the
    Intel® oneAPI Threading Building Blocks (oneTBB)
    include directory when working with programs that use
    oneTBB
    , set the
    TBBROOT
     environment variable. See Defining the TBBROOT Environment Variable.
  • On Linux OS and macOS:
     set the
    BROWSER
     environment variable to locate an installed HTML browser. This enables the display of Get Started, Tutorials or Help from the
    Intel® Advisor
     GUI
    Help
    menu.
  • On Linux OS and macOS:
     set the
    VISUAL
     or
    EDITOR
     environment variable to specify an external editor to launch when you double-click a line in a
    Source
     window.
    VISUAL
     takes precedence over
    EDITOR
    .

Next Steps

Launch
Intel Advisor
 from GUI or from command line interface.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.