Temporary Directory for Performance Results on Linux* Targets
Configure a temporary directory for the remote or local data collection on Linux target systems.
When performing a
hardware event-based sampling collection with the
Intel® VTune™
or configuring the result directory for analysis on a mounted share, temporary data files are written to the system global temporary directory. Typically the global temporary directory is Profiler
/tmp
.
Depending on the length of the
VTune
analysis and data collected, significant temporary disk space may be required. The temporary data may exceed the current allocated or available global temporary storage space. If the system global temporary space is exceeded, the
Profiler
VTune
analysis may fail with a warning similar to the following:
Profiler
Warning: Cannot load data file `/home/user/r001hs/data.0/tbs0123456789.tb6' (tbrw call…..) failed: Invalid sample file (24)
. Note that the
VTune
temporary files may no longer be in the temporary storage location, giving you the false impression that there is plenty of space available. In this case, you may wish to check the temporary storage usage while the analysis is running. If the usage of system temporary storage reaches 100%, this may be the root cause of the error.
Profiler
If the cause of the error is insufficient temporary disk space, you may set up an alternative temporary directory for collected data.
VTune
may still keep writing some scratch files of insignificant size (for example, the socket file
Profiler
sep_ipc_socket_0
) to the system global temporary directory. However, it will utilize the defined alternative temporary location for the larger files such as those beginning with
lwp
(for example, lwp28478__wallclock.tb7
,
lwp28478_user.mrk
,
lwp28478_7.txt
). When the
VTune
completes
finalization, all temporary scratch files are automatically removed.
Profiler
Configuring an Alternative Temporary Directory for Local Targets
For local targets, you may set the standard Linux
TMPDIR
environment variable to an alternate directory path with the sufficient temporary storage space. To configure the
TMPDIR
environment variable, do the following:
- From within the shell where you will be running theVTunecommand line or GUI, assign a value and exportProfilerTMPDIR, for example:> export TMPDIR=/directory_path/ tmp
- Verify the assignment:> echo $TMPDIR
- Verify directory permissions are sufficient for the directory assigned toTMPDIR:> ls -ld /directory_path/ tmp
- From the shell window, run theVTunehardware event-based sampling collection using either the command line or GUI.Profiler
Configuring an Alternative Temporary Directory for Remote Targets
To change the temporary directory for remote targets from GUI, do the following:
- Click theConfigure Analysisbutton.
- Select theremote Linux (SSH)target system.
- In theTemporary directory on the remote systemfield specify your alternative temporary directory.
To specify an alternative temporary directory from the command line, use the
option, for example:
host>./vtune --target-system=ssh:vtune@10.125.21.170 -target-tmp-dir=/home/tmp –collect hotspots -knob sampling-mode=hw -knob enable-stack-collection=true -- /home/samples/matrix