User Guide

Contents

Launch
Intel® Advisor Beta
from a Docker* Container for Linux* OS

This section contains steps to run
Intel® Advisor Beta
in a Docker* container. Containers allow you to set up and configure environments and distribute them using images:
  • You can install an image containing an environment pre-configured with all the tools you need, then develop within that environment.
  • You can save an environment and use the image to move that environment to another machine without additional setup.
  • You can prepare containers with different sets of compilers, tools, libraries, or other components, as needed.
This is a feature of
Intel® Advisor Beta
installed as part of the
Intel® oneAPI Base Toolkit
Set up the Docker container
  1. Pull the Docker image from the Intel oneAPI Containers Repository with the following commands:
    image=amr-registry.caas.intel.com/oneapi/oneapi:base-dev-ubuntu18.04 docker pull "$image"
  2. Run the Docker container using the following command:
    docker run --cap-add=SYS_PTRACE -it "$image"
    • The
      --device=/dev/dri option
      enables the gpu (if available).
    • You can specify proxy information using options as follows:
      -e http_proxy="$http_proxy" -e https_proxy="$https_proxy"
  3. For the rest of the steps in this section, run any commands from the command line prompt inside the Docker container.
    For example, to set up the Mandelbrot sample, you can run:
    cd /one-api-code-samples/HPC/mandelbrot make ./main -d1 ./main -t gpu # run on gpu ./main -t cpu # run on cpu make clean
  4. Run the following commands to source Advisor variables:
    This step is not required, but allows you to run tools from any directory, rather than using absolute file paths.
    source /opt/intel/oneapi/advisor/latest/advixe-vars.sh
  5. Now that your Docker container is running, you can run Advisor from the command line as you would without a container. For example:
    /opt/intel/oneapi/advisor/latest/bin64# advixe-cl --collect survey /bin/ls

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804