Refresh rocm installation and profiler blogs

Co-authored-by: Thomas Gibson <[email protected]>
Co-authored-by: doscherda <[email protected]>

Author: 3 people

profilers/README.md

@@ -59,10 +59,9 @@ The following terms are used in this blog post:
 | [AMD "Zen" Core](https://www.amd.com/en/technologies/zen-core)| AMD's x86-64 processor core architecture design. Used by the AMD EPYC™, AMD Ryzen™, AMD Ryzen™ PRO, and AMD Threadripper™ PRO processor series.|
 | [RDNA™](https://www.amd.com/en/technologies/rdna) | AMD's Traditional GPU architecture optimized for graphically demanding workloads like gaming and visualization. Includes the RX 5000, 6000 and 7000 GPUs. |
 | [CDNA™](https://www.amd.com/en/technologies/cdna) | AMD's Compute dedicated GPU architecture optimized for accelerating HPC, ML/AI, and data center type workloads. Includes the AMD Instinct™ MI50/60, MI100, and MI200 series accelerators.|
-| [GCN](https://www.amd.com/en/technologies/gcn)   | AMD's pre-CDNA™/RDNA™ GPU architecture |
-| [HIP](https://docs.amd.com/bundle/HIP-Programming-Guide-v5.3/page/Introduction_to_HIP_Programming_Guide.html) | A C++ Runtime API and kernel language that allows developers to create portable compute kernels/applications for AMD and NVIDIA GPUs from a single source code |
-| Timeline Trace | A profiling approach where durations of compute kernels and data transfers between devices are collected and visualized |
-| [Roofline Analysis](https://enccs.github.io/AMD-ROCm-development/hierarchical_roofline/) | Hardware agnostic methodology for quantifying a workload's ability to saturate the given compute architecture in terms of floating-point compute and memory bandwidth |
+| [HIP](https://rocm.docs.amd.com/projects/HIP/en/latest/user_guide/programming_manual.html) | A C++ Runtime API and kernel language that allows developers to create portable compute kernels/applications for AMD and NVIDIA GPUs from a single source code |
+| [Timeline Trace](https://amdresearch.github.io/omnitrace/output.html#perfetto-output) | A profiling approach where durations of compute kernels and data transfers between devices are collected and visualized |
+| [Roofline Analysis](https://amdresearch.github.io/omniperf/profiling.html#standalone-roofline) | Hardware agnostic methodology for quantifying a workload's ability to saturate the given compute architecture in terms of floating-point compute and memory bandwidth |
 | Hardware Counters | Individual metrics which track how many times a certain event occurs in the hardware, such as bytes moved from L2 cache or a 32 bit floating point add performed |
 
 ## What tools to use?
@@ -223,7 +222,7 @@ and collecting counters during the execution.
 
 The `rocprof` utility also depends on the
 [ROC-tracer](https://github.com/ROCm-Developer-Tools/roctracer) and
-[ROC-TX](https://docs.amd.com/en-US/bundle/ROCTracer-User-Guide-v5.0-/page/ROCTX_Application_Code_Annotation.html)
+[ROC-TX](https://rocm.docs.amd.com/projects/roctracer/en/latest/roctracer_spec.html#)
 libraries, giving it the ability to collect timeline traces of the GPU software stack
 as well as user anotated code regions. Note that `rocprof` is a command-line only
 utility so input and output takes the format of txt and CSV files. These formats
@@ -234,8 +233,8 @@ but requires extra effort to analyze the collected data.
 ### Radeon™ GPU Profiler
 
 The [Radeon™ GPU Profiler](https://radeon-gpuprofiler.readthedocs.io/en/latest/) is a performance tool that can be used by traditional
-gaming and visualization developers to optimize DirectX 12 (DX12), Vulkan™ for AMD
-RDNA™ and GCN hardware. The Radeon™ GPU Profiler (RGP) is a ground-breaking
+gaming and visualization developers to optimize DirectX 12 (DX12) and Vulkan™ for AMD
+RDNA™ hardware. The Radeon™ GPU Profiler (RGP) is a ground-breaking
 low-level optimization tool from AMD. It provides detailed timing information
 on Radeon™ Graphics using custom, built-in, hardware thread-tracing, allowing
 the developer deep inspection of GPU workloads.  This unique tool generates

rocm-installation/README.md

@@ -23,9 +23,11 @@ SOFTWARE.
 
 AMD ROCm™ is the first open-source software development platform for HPC/Hyperscale-class GPU computing. AMD ROCm™ brings the UNIX philosophy of choice, minimalism and modular software development to GPU computing. Please see the AMD [Open Software Platform for GPU Compute](https://www.amd.com/en/graphics/servers-solutions-rocm) and [ROCm Informational Portal](https://rocm.docs.amd.com/) pages for more information. 
 
+More detailed information on ROCm installation is available on the [Deploy ROCm on Linux](https://rocm.docs.amd.com/en/latest/deploy/linux/index.html) page. 
+
 Installation of the AMD ROCm™ software package can be challenging without a clear understanding of the pieces involved and the flow of the installation process. This introductory material shows how to install ROCm on a workstation with an AMD GPU card that supports the AMD GFX9 architecture. A follow on blog will discuss installing ROCm in other environments, such as a Docker Container, Linux LXC or a full HPC installation. 
 
-The website [https://rocm.docs.amd.com](https://rocm.docs.amd.com) contains links to the Release, Support and API documentation for ROCm. Please refer to the [Installation Guide](https://rocm.docs.amd.com/en/latest/deploy/linux/) and [Hardware / Software Support Guide](https://rocm.docs.amd.com/en/latest/release/gpu_os_support.html) for the software and hardware supported by the V 5.4 release of ROCm. This post will be based on an Ubuntu 20.04 operating system and the AMD MI50 GPU card. The full installation process is documentated in the [Installation Guide](https://rocm.docs.amd.com/en/latest/deploy/linux/).
+The website [https://rocm.docs.amd.com](https://rocm.docs.amd.com) contains links to the Release, Support and API documentation for ROCm. Please refer to the [Installation Guide](https://rocm.docs.amd.com/en/latest/deploy/linux/) and [Hardware / Software Support Guide](https://rocm.docs.amd.com/en/latest/release/gpu_os_support.html) for the software and hardware supported by the V 5.7 release of ROCm. This post will be based on an Ubuntu 22.04 operating system and the AMD MI (MI210, MI250, etc.) series GPU card. The full installation process is documentated in the [Installation Guide](https://rocm.docs.amd.com/en/latest/deploy/linux/).
 
 AMD ROCm™ is a brand name for the ROCm open software platform supporting GPUs using AMD's CDNA, and RDNA GPU architectures. The platform includes drivers and runtimes for libraries and developer tools.
 
@@ -37,12 +39,12 @@ AMD ROCm™ is a brand name for the ROCm open software platform supporting GPUs
 
 ## Option 1
 
-AMD provides an installation script for specific operating system and ROCm versions. The script name and download location can be different for each combination of O/S and ROCm so check the [How to Install page](https://rocm.docs.amd.com/en/latest/deploy/linux/installer/install.html) for your specific combination. We are using Ubuntu 20.04 and installing ROCm 5.4.3 and find that the script is named *amdgpu-install_5.4.50403-1_all*.
+AMD provides an installation script for specific operating system and ROCm versions. The script name and download location can be different for each combination of O/S and ROCm so check the [How to Install page](https://rocm.docs.amd.com/en/latest/deploy/linux/installer/install.html) for your specific combination. We are using Ubuntu 22.04 and installing ROCm 5.7.1 and find that the script is named *amdgpu-install_5.7.50701-1_all*.
 
 ```bash
-sudo apt-get update
-wget https://repo.radeon.com/amdgpu-install/5.4.3/ubuntu/focal/amdgpu-install_5.4.50403-1_all.deb
-sudo apt install ./amdgpu-install_5.4.50403-1_all.deb
+sudo apt update
+wget https://repo.radeon.com/amdgpu-install/5.7.1/ubuntu/jammy/amdgpu-install_5.7.50701-1_all.deb
+sudo apt install ./amdgpu-install_5.7.50701-1_all.deb
 ```
 Once the amdgpu-install script has been extracted,  it can be used to install the kernel code, libraries and developer code. For a typical HPC environment HIP, ROCm and the kernel drivers should be sufficient:
 ```bash
@@ -67,27 +69,27 @@ To remove all old versions use:
 sudo amdgpu-uninstall --rocmrelease=all
 ```
 
-AMD provides an installation script for specific operating system and ROCm versions. The script name and download location can be different for each combination of O/S and ROCm so check the [How to Install page](https://rocm.docs.amd.com/en/latest/deploy/linux/installer/install.html) for your specific combination. We are using Ubuntu 20.04 and installing ROCm 5.4 and find that the script is named *amdgpu-install_5.4.50400-1_all*.
+AMD provides an installation script for specific operating system and ROCm versions. The script name and download location can be different for each combination of O/S and ROCm so check the [How to Install page](https://rocm.docs.amd.com/en/latest/deploy/linux/installer/install.html) for your specific combination. We are using Ubuntu 22.04 and installing ROCm 5.7.1 and find that the script is named *amdgpu-install_5.7.50701-1_all*.
 
 ```bash
-sudo apt-get update
-wget https://repo.radeon.com/amdgpu-install/5.4/ubuntu/focal/amdgpu-install_5.4.50400-1_all.deb
-sudo apt-get install ./amdgpu-install_5.4.50400-1_all.deb
+sudo apt update
+wget https://repo.radeon.com/amdgpu-install/5.7.1/ubuntu/jammy/amdgpu-install_5.7.50701-1_all.deb
+sudo apt install ./amdgpu-install_5.7.50701-1_all.deb
 ```
 Once the amdgpu-install script has been extracted,  it can be used to install the kernel code, libraries and developer code.
-The steps below will install the kernel driver code at level 5.4.0 and the libraries at level 5.4.0, 5.3.2 and 5.2.3. For a typical HPC environment, HIP and the ROCm libraries should be sufficient:
+The steps below will install the kernel driver code at level 5.7.1 and the libraries at level 5.7.0 and 5.7.1. For a typical HPC environment, HIP and the ROCm libraries should be sufficient:
 ```bash
-sudo amdgpu-install --usecase=hiplibsdk,rocm,dkms --rocmrelease=5.4.0
-sudo amdgpu-install --usecase=hiplibsdk,rocm --rocmrelease=5.3.2 --no-dkms
-sudo amdgpu-install --usecase=hiplibsdk,rocm --rocmrelease=5.2.3 --no-dkms
+sudo amdgpu-install --usecase=hiplibsdk,rocm,dkms --rocmrelease=5.7.1
+sudo amdgpu-install --usecase=hiplibsdk,rocm --rocmrelease=5.7.0 --no-dkms
+sudo amdgpu-install --usecase=hiplibsdk,rocm --rocmrelease=5.7.1 --no-dkms
 ```
 Additional libraries can be installed and the list of available use cases can be found using:
 ```bash
 sudo amdgpu-install --list-usecase
 ```
 The ROCm code installs to /opt/rocm by default. You can verify that ROCm is installed by running
 ```bash
-/opt/rocm-5.4.0/bin/rocminfo
+/opt/rocm-5.7.1/bin/rocminfo
 ```
 and checking that the card was detected by the software. The supported GPU card will start with "GFX9". 
 
@@ -98,7 +100,7 @@ The full apt-get process is shown on the [How to Install page](https://rocm.docs
 
 Determine the location of the ROCm software to install and HIP and the related ROCm software:
 ```bash
-export ROCM_REPO_BASEURL="https://repo.radeon.com/rocm/apt/5.4/"
+export ROCM_REPO_BASEURL="https://repo.radeon.com/rocm/apt/5.7.1/"
 export ROCM_REPO_COMP="ubuntu"
 export ROCM_REPO_BUILD="main"
 echo "deb [arch=amd64 trusted=yes] ${ROCM_REPO_BASEURL} ${ROCM_REPO_COMP} ${ROCM_REPO_BUILD}" > /etc/apt/sources.list.d/rocm.list