Install with Package Managers
On Linux* OS, learn how to install Intel® VTune™ Profiler using the APT, YUM, DNF, or Zypper package managers.
Before You Begin
Make sure that your operating system is supported. Check System Requirements.
If you have not installed Intel® oneAPI software products using package managers previously, configure your package manager to work with the repository. Follow instructions in the sections below.
APT
If you have not installed Intel® oneAPI Toolkits or components previously, configure your package managers to use Intel repositories:
- (Optional) Switch to any directory with write access. This example uses /tmp:
cd /tmp
- Download the Intel repository public key. Use wget:
wget https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB
- Add the public key to your apt keyring:
sudo apt-key add GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB
- (Optional) Remove the public key file, since this is no longer required:
rm GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB
- Configure the APT client to use the Intel repository:
echo "deb https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
If the add-apt-repository utility is installed, run this command instead:
sudo add-apt-repository "deb https://apt.repos.intel.com/oneapi all main"
- Update the APT package lists:
sudo apt update
- Install the VTune Profiler standalone package:
sudo apt install intel-oneapi-vtune
YUM
If you have not installed Intel® oneAPI Toolkits or components previously, configure your package managers to use Intel repositories:
- In a directory that has write access, create a YUM/DNF .repo file. This example uses /tmp:
tee > /tmp/oneAPI.repo << EOF [oneAPI] name=Intel® oneAPI repository baseurl=https://yum.repos.intel.com/oneapi enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://yum.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB EOF
- Move the oneAPI.repo file that you just created, to the YUM/DNF configuration directory (/etc/yum.repos.d):
sudo mv /tmp/oneAPI.repo /etc/yum.repos.d
Run this command:
sudo yum install intel-oneapi-vtune
DNF
If you have not installed Intel® oneAPI Toolkits or components previously, configure your package managers to use Intel repositories:
- In a directory that has write access, create a YUM/DNF .repo file. This example uses /tmp:
tee > /tmp/oneAPI.repo << EOF [oneAPI] name=Intel® oneAPI repository baseurl=https://yum.repos.intel.com/oneapi enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://yum.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB EOF
- Move the oneAPI.repo file that you just created, to the YUM/DNF configuration directory (/etc/yum.repos.d):
sudo mv /tmp/oneAPI.repo /etc/yum.repos.d
Run this command:
sudo dnf install intel-oneapi-vtune
Zypper
If you have not installed Intel® oneAPI Toolkits or components previously, configure your package managers to use Intel repositories.
Run this command to add the Intel repository key:
sudo zypper addrepo https://yum.repos.intel.com/oneapi oneAPI
Run this command:
sudo zypper install intel-oneapi-vtune
After you Install VTune Profiler
To use the command line interface of VTune Profiler, set environment variables first. Run these scripts:
bash:
source /opt/intel/oneapi/vtune/latest/env/vars.sh
csh/tcsh:
source /opt/intel/oneapi/vtune/latest/env/vars.csh
To verify if you installed VTune Profiler correctly or troubleshoot issues with the installation, use the self-check script (vtune-self-checker.sh) available in the package. This script runs a set of analyses on a sample application, and reports the progress interactively.
Before you run the self-check script, make sure to set environment variables.
Next, open a terminal window.
Go to this location: /opt/intel/oneapi/vtune/latest/bin64/
Run the vtune-self-checker.sh script:
vtune-self-checker.sh
The self-check script may take several minutes to run all necessary checks.
Once the script completes all checks, review the summary. Check if any analyses failed, and see the log file for additional information.
If you install VTune Profiler without superuser privileges, you must complete additional configuration steps to enable hardware analyses through Linux Perf*.
To learn about these steps and possible limitations, see this technical recipe on Profiling Hardware Without Intel Sampling Drivers.
Learn More
- See guided examples in the Get Started Guide.
- Follow a comprehensive tutorial to Analyze Common Performance Bottlenecks
- Learn about analysis types, workflows, and command line use in the User Guide
- Browse through technical recipes that address typical use cases and challenges in the Performance Analysis Cookbook