Preparing a Target Linux* Embedded System for Remote Analysis

Setting up SSH for Remote Collection

Configure SSH to work in password-less mode so it does not prompt for the password on each invocation. To do this, use the key generation utility on the host system:

host> ssh-keygen

host> cat ~/.ssh/id_rsa.pub | ssh user@target 'cat >> ~/.ssh/authorized_keys'

For remote collection with Cygwin*, set up the password-less mode as follows:

1. Set a path to the Cygwin bin directory:

   host> set PATH=CYGWIN_ROOT\bin;%path%

2. Create a user directory in CYGWIN_ROOT\home if it does not exist:

   host> mkdir CYGWIN_ROOT\home\hostuser

3. Generate the dsa key with an empty passphrase:

   host> ssh-keygen -t dsa

4. Set correct permissions on the generated file:

   host> chmod 600 /home/hostvtune/.ssh/id_dsa

5. Make sure the .ssh directory exists in the home directory on your device. If it is missing, create it.

   host> ssh user@target mkdir -p /home/user/.ssh

6. Copy the generated id_dsa.pub file to the device:

   host> scp /home/user/.ssh/id_dsa.pub user@target:/home/user/.ssh/authorized_keys

For remote collection with PuTTY* Plink, set up the password-less mode as follows:

1. Download puttygen.exe from the PuTTY download page.

2. In the PuTTY Key Generator dialog box, click the Generate button (with all default settings intact) to generate keys.

3. Save the private key to your local drive, for example: C:\temp\linux_private_key.ppk.

4. Copy the public key from the PuTTY Key Generator dialog box and paste it to the file in the shared Linux /home directory: ~/.ssh/authorized_keys. If the file is absent, create it.

5. In the PuTTY Configuration dialog box, make sure to have the following settings:

When you set the password-less mode, run any command to verify that a password is not required anymore, for example:

host> ssh user@target ls

Building and Installing the Drivers

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

1. Build the sampling driver and power driver on the host.

   Note

   • Make sure kernel headers correspond to the kernel version running on the device.

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

2. Copy <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 scripts do not work on the target system due to absence of standard Linux commands, you may install drivers manually using the insmod command.

Installing the VTune Amplifier Collector on the Target Device

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

1. Copy the system_studio_target.tgz file, located at C:\Program Files\Intel\System Studio 2014.0.xxx\targets, to the target device using ftp, sftp or scp.

2. On the target device, unpack the product package to a directory where you have write access:

   target> tar -zxvf system_studio_target.tgz

   VTune Amplifier target data collector is located in the newly created directory ..system_studio_target\ vtune_amplifier_2014_for_systems\target.

When collecting data remotely, amplxe-runss.py looks for the collector on the target device in its default location: /opt/intel/vtune_amplifier_<version>. It also temporary stores performance results on the target system in the /tmp directory. If you installed the collector to a different location and need to specify another temporary directory, you can use the following environment variable on the host:

host> export AMPLXE_TARGET_PRODUCT_DIR=<another path to target collector>

host> export AMPLXE_TARGET_TMP_DIR=<another temporary directory>