Preparing a Target Linux* System for Remote Analysis

Installing the VTune Amplifier Collectors on the Target Device

To install the VTune Amplifier collectors on a regular Linux target system (applicable to the VTune Amplifier XE):

Prerequisite for macOS host system: Download the Linux installation package to your macOS system and extract the contents to a writeable directory.

1. Copy the CLI_install folder from the top level in the extracted product install package to the remote Linux machine.

2. On the target system, run the ./install.sh script file located in the CLI_install folder. No activation is required.

To install the VTune Amplifier collectors on an embedded or regular Linux system (applicable to the Intel VTune Amplifier for Systems):

From a Linux host system to an embedded or regular Linux system:

1. Copy the required target package archive, located at <install_dir>/target/linux32[64], to the target device using ftp, sftp, or scp. The following target packages are available:

   • linux32/vtune_amplifier_target_sep_x86.tgz - provides hardware event-based sampling collector only (SEP) for x86 systems

   • linux32/vtune_amplifier_target_x86.tgz - provides all VTune Amplifier collectors for x86 systems

   • linux64/vtune_amplifier_target_sep_x86_64.tgz - provides hardware event-based sampling collector only (SEP) for 64-bit systems

   • linux64/vtune_amplifier_target_x86_64.tgz - provides all VTune Amplifier collectors for 64-bit systems

   Note

   • Use both *_x86 and *_x86_64 packages if you plan to run and analyze 32-bit processes on 64-bit systems.

   • Remote collectors are also available in the <Intel_System_studio_install_dir>/targets/ system_studio_target.tgz.

2. On the target device, unpack the product package to the /opt/intel directory:

   target> tar -zxvf <target_package>.tgz

   VTune Amplifier target package is located in the newly created directory /opt/intel/vtune_amplifier_<version>_for_systems.<package_num>.

From a macOS host system to a regular Linux system:

1. Download the Linux installation package to your macOS host system.
2. Copy the installation package to your remote Linux system.
3. Extract the installation package on the remote Linux system.

4. Run the ./install.sh script file located in the CLI_install folder. No activation is required.

From a macOS host system to an embedded Linux system:

1. Download the Linux installation package to your macOS host system.
2. Copy the installation package to a writeable directory.
3. Copy the CLI_install folder from the top level in the extracted product install package to the remote Linux machine.

4. On the target system, run the ./install.sh script file located in the CLI_install folder. No activation is required.

When collecting data remotely, the VTune Amplifier looks for the collectors on the target device in its default location: /opt/intel/vtune_amplifier_<version>_for_systems.<package_num>. It also temporary stores performance results on the target system in the /tmp directory. If you installed the target package to a different location and need to specify another temporary directory, make sure to configure your target properties in the Analysis Target tab as follows:

• Use the VTune Amplifier installation directory on the remote system option to specify the path to the VTune Amplifier on the remote system. If default location is used, the path is provided automatically.

• Use the Temporary directory on the remote system option to specify a non-default temporary directory.

Alternatively, use the-target-install-dir and -target-tmp-diramplxe-cl options from command line.

Building and Installing the Drivers

To enable hardware event-based sampling analysis on your target device:

1. Build the sampling driver and power driver on the target system.

   Note

   • Make sure kernel headers correspond to the kernel version running on the device. For details, see the README.txt files in the sepdk/src and powerdk/src directories.

   • Make sure compiler version corresponds to the architecture (x86 or x86_64) of the kernel running on the target system.

   • For Advanced Hotspots, General Exploration and Custom event-based sampling analysis types, you may not need root credentials and installing the sampling driver for systems with kernel 2.6.32 or higher, which exports CPU PMU programming details over /sys/bus/event_source/devices/cpu/format file system. Your operating system limits on the maximum amount of files opened by a process as well as maximum memory mapped to a process address space still apply and may affect profiling capabilities. These capabilities are based on Linux Perf* functionality and all its limitations fully apply to the VTune Amplifier as well. For more information, see the Tutorial: Troubleshooting and Tips topic at https://perf.wiki.kernel.org/index.php/Main_Page.

2. Copy the <install_dir>/sepdk and <install_dir>/powerdk folders to the /opt/intel/vtune_amplifier_<version> directory on the target device.

   You may choose another directory if this location is not accessible/does not exist or you can mount those folders via NFS.

3. On the target device, install the drivers.

   If the insmod-sep script does not work on the target system due to absence of standard Linux commands, you may install drivers manually using the Linux OS insmod command directly.