3. Installing AMD uProf

Download the latest version of the AMD uProf installer package for the supported operating systems from the AMD uProf Downloads page. You can install it using Windows, Linux, or FreeBSD.

3.1. Installing Using Windows

Run the 64-bit Windows installer binary AMDuProf-x.y.z.exe.

The executables, libraries, and the other required files are installed in the folder C:\Program Files\AMD\AMDuProf\.

3.1.1. Sample Programs

A few sample programs are installed along with the product for you to use with the tool:

A sample matrix multiplication application:

C:\Program Files\AMD\AMDuProf\Examples\AMDTClassicMatMul\bin\AMDTClassicMatMul.exe

3.2. Installing Using Linux

3.2.1. Installing Using TAR File

Extract the tar.bz2 binary file and install AMD uProf using the following command:

$ tar -xf AMDuProf_Linux_x64_x.y.z.tar.bz2

Note

The Power Profiler Linux Driver must be installed manually.

3.2.2. Installing Using a RPM Package (RHEL)

Run the following rpm or yum command to install the AMD uProf RPM package:

sudo rpm --install amduprof-x.y-z.x86_64.rpm
sudo yum install amduprof-x.y-z.x86_64.rpm

After the installation is complete, the executables, libraries, and the other required files will be installed in the directory: /opt/AMDuProf_X.Y-ZZZ/.

3.2.3. Installing Using a Debian Package (Ubuntu)

Install the AMD uProf Debian package using the following dpkg command:

$ sudo dpkg --install amduprof_x.y-z_amd64.de

After the installation is complete, the executables, libraries, and the other required files will be installed in the directory: /opt/AMDuProf_X.Y-ZZZ/.

3.2.4. Installing Power Profiling Driver on Linux

When you install AMD uProf using RPM or Debian packages, the Power Profiler Linux Driver is built and installed automatically. If you download the AMD uProf tar.bz2 archive, you must manually install the Power Profiler Linux Driver.

Note

If the Power Profiling driver installation fails due to a kernel GCC version mismatch (as stated in the warning message), make sure the GCC version used to build the kernel is also present on the system.

Ensure that the GCC and MAKE software packages are installed before installing the Power Profiler Driver. If you do not have these packages, you can install them using the following commands:

Note

By default, the GCC 11 PP driver installation fails on Ubuntu 24.04 and needs GCC 12 to proceed with the installation. This is because, by default, Ubuntu 24.04 comes bundled with GCC 11 but the kernel is built upon GCC 12. Hence, GCC 12 must be installed in this case.

To install the driver, run the following commands:

$ tar –xf AMDuProf_Linux_x64_x.y.z.tar.bz2
cd AMDuProf_Linux_x64_x.y.z/bin
$ sudo ./AMDPowerProfilerDriver.sh install

The installer will create a source tree for Power Profiler Driver in the directory /usr/src/AMDPowerProfiler-<version>. All the source files required for module compilation are in this directory and under MIT license.

To uninstall the driver, run the following commands:

$ cd AMDuProf_Linux_x64_x.y.z/bin
$ sudo ./AMDPowerProfilerDriver.sh uninstall

3.2.5. Linux Power Profiling Driver Support for DKMS

You can install Power Profiling Driver with Dynamic Kernel Module Support (DKMS) framework support on Linux machines. DKMS framework automatically upgrades the Power Profiler Driver module whenever there is a change in the existing kernel. This saves you from manually upgrading the power profiling driver module. The DKMS package must be installed on target machines before running the installation steps mentioned in the above section.

AMDPowerProfilerDriver.sh installer script will automatically handle the DKMS related configuration if the DKMS package is installed on the target machine.

Example (for Ubuntu distros)

$ sudo apt-get install dkms
$ tar –xf AMDuProf_Linux_x64_x.y.z.tar.bz2
$ cd AMDuProf_Linux_x64_x.y.z/bin
$ sudo ./AMDPowerProfilerDriver.sh install

If you upgrade the kernel version frequently, we recommend you use DKMS for the installation.

3.2.6. Sample Programs

3.3. Installing Using FreeBSD

Extract the tar.bz2 binary file and install AMD uProf.

$ tar -xf AMDuProf_FreeBSD_x64_x.y.z.tar.bz2

3.3.1. Sample Programs

A sample matrix multiplication program with Makefile

/<install dir>/AMDuProf_FreeBSD_x64_X.Y.ZZZ/Examples/AMDTClassicMat/