Ingredients

Performance analysis tools
:
Intel Advisor
2019 Update 1
The latest version is available for download at https://software.intel.com/content/www/us/en/develop/tools/advisor/choose-download.html.
Platform
: AWS EC2 instance
Other tools
: PuTTY, WinSCP, and VNC* technology

Prerequisites

Identify the default user name for the Amazon* Machine Image (AMI) at https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html.
Gather all the tools and supporting files you need to upload, such as the
Intel Advisor
installation package, the Intel® compiler installation package, the target application, supporting libraries, etc.

Launch an AWS EC2 Instance

Public IP address:

Private key file:

Connect to the AWS EC2 Instance Using PuTTY

Configure the secure SSH connection. During configuration, enter:
The private key file in
Connection
SSH
Options controlling SSH authentication
Authentication parameters
Private key file for authentication
:

The public IP address in
Session
Basic options for your PuTTY session
Specify the destination you want to connect to
Host Name (or IP address)
:

Establish the secure SSH connection and log in using the default user name for the AMI:

Upload All Tools, Applications, and Supporting Files to the AWS EC2 Instance Using WinSCP

Configure the WinSCP connection. During configuration, enter the:
The public IP address in
Session
Host name
The default user name for the AMI in
Session
User name

The private key file in
Session
Advanced Site Settings
SSH
Authentication
Private key file for authentication

Log in to the AWS EC2 instance.
Upload the
Intel Advisor
installation package, the target application, and all other supporting tools, libraries, and files.

Install and Set Up the

Intel Advisor

and Other Supporting Tools

Uncompress the

Intel Advisor

installation package.

Launch the installation executable.

During installation, you may be asked to install external libraries upon which the

Intel Advisor

depends. In this recipe, libraries were uploaded from the following entities: GTK, Pango, ALSA, and X.Org.

Set up the

Intel Advisor

:

source /opt/intel/advisor_2019.1.0.579143/advixe-vars.sh

Use the

Intel Advisor

GUI to Analyze Performance

Set up a GUI in the AWS EC2 instance:
Install VNC technology and necessary libraries.
Run a VNC server.
Create an SSH tunnel with the correct port number.
Connect to the AWS EC2 instance using a VNC viewer.
Launch
advixe-gui
to open the
Intel Advisor
GUI.

Alternative Steps

Collect Roofline data:

$ advixe-cl --collect=survey --project-dir=./myAdvisorProj -- myTargetApp
$ advixe-cl --collect=tripcounts --flop --no-trip-counts --project-dir=./myAdvisorProj -- myTargetApp

Generate a Roofline report in an interactive HTML format that does not require the

Intel Advisor

for display:

$ advixe-cl --report=roofline --project-dir=./myAdvisorProj

Generate a Summary report in text format and save it to the

out

directory:

$ advixe-cl --report=summary --project-dir=./myAdvisorProj --format=text --report-output=./out/summary.txt

Create a read-only snapshot to package performance data, sources, and binaries for further investigation, save it to the

tmp

directory, and name it

myAdvisorProjSnapshot.advixeexpz

:

$ advixe-cl --snapshot --project-dir=./myAdvisorProj --pack --cache-sources --cache-binaries -- ./tmp/myAdvisorProjSnapshot