About Installing Drivers

Intel® VTune™ Amplifier uses kernel drivers to enable the hardware event-based sampling and power analysis. VTune Amplifier installer automatically uses the Sampling Driver Kit and the Power Driver Kit to build a driver for your kernel. If the drivers were not built and set up during installation (for example, lack of privileges, missing kernel development RPM, and so on), they can be compiled and loaded manually later using these Driver Kits. See the following topics for manual driver build and set up information:

Note

  • If the driver was not properly installed or unavailable for the current system, the VTune Amplifier cannot run hardware event-based sampling or power analysis types and displays an error message.

  • You may need kernel header sources and other additional software to build and load the kernel drivers on Linux. For details, see the README.txt files in the sepdk/src and powerdk/src directories.

  • A Linux kernel update can lead to incompatibility with VTune Amplifier drivers set up on the system for event-based sampling (EBS) analysis and power analysis. If the system has installed VTune Amplifier boot scripts to load the drivers into the kernel each time the system is rebooted, the drivers will be automatically re-built by the boot scripts at system boot time. Kernel development sources required for driver rebuild should correspond to the Linux kernel update.

To build the drivers, choose the Change advanced options item during installation. VTune Amplifier provides the following advanced options:

Use This Option

To Do This

Sampling driver install type [build driver (default) / driver kit files only ]

Power driver install type [build driver (default) / driver kit files only ]

Choose the driver installation option. By default, VTune Amplifier uses the Sampling/Power Driver Kit to build the driver for your kernel. You may change the option to driver kit files only if you want to build the driver manually after installation.

Driver access group [ vtune (default) ]

Set the driver access group ownership to determine which set of users can perform the collection on the system. By default, the group is vtune. You may set your own group during installation in the Advanced options or change it manually after installation by executing: ./boot-script -–group <your_group> from the <install_dir>/sepdk/src or <install_dir>/powerdk/srcdirectories.

By default, <install_dir> is /opt/intel/<vtune_amplifier_version>.

Driver permissions [ 660 (default) ]

Change permissions for the driver.

Load driver [ yes (default) ]

Load the driver into the kernel.

Install boot script [ yes (default) ]

Use a boot script that loads the driver into the kernel each time the system is rebooted. The boot script can be disabled later by executing: ./boot-script --uninstall from the <install_dir>/sepdk/src or <install_dir>/powerdk/src directories.

Enable per-user collection mode [no (default) / yes]

Install the hardware event-based collector driver with the per-user filtering on. When the filtering is on, the collector gathers data only for the processes spawned by the user who started the collection. When it is off (default), samples from all processes on the system are collected. Consider using the filtering to isolate the collection from other users on a cluster for security reasons. The administrator/root can change the filtering mode by rebuilding/restarting the driver at any time. A regular user cannot change the mode after the product is installed.

Driver build options …

Specify the location of the kernel header files on this system, the path and name of the C compiler to use for building the driver, the path and name of the make command to use for building the driver.

For more complete information about compiler optimizations, see our Optimization Notice.