Install ROCm Validation Suite

Install ROCm Validation Suite#

ROCm Validation Suite (RVS) is supported on AMD Instinct and Radeon GPUs supported by ROCm. See the ROCm compatibility matrix for support information.

For advanced workflows, source builds, or custom configurations, see ROCm/ROCmValidationSuite.

Note

TransferBench is now a part of the ROCm Validation Suite and is installed with it. See the TransferBench documentation for more information.

Prerequisites#

Install the ROCm Core SDK before installing RVS. For instructions, see Install AMD ROCm. Use the selector panel on that page to view instructions appropriate for your system environment.

Package manager installation#

Use the following steps to install RVS using your distribution’s package manager on top of the ROCm Core SDK.

  1. Register the RVS repository.

    sudo mkdir --parents --mode=0755 /etc/apt/keyrings
    wget https://repo.amd.com/rocm/packages-multi-arch/gpg/rocm.gpg -O - | gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
    sudo tee /etc/apt/sources.list.d/rvs.list << EOF
    deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/rvs/packages/deb/ stable main
    EOF
    
    sudo apt update
    
    sudo tee /etc/yum.repos.d/rvs.repo <<EOF
    [rvs]
    name=ROCm Validation Suite
    baseurl=https://repo.amd.com/rocm/rvs/packages/rpm/x86_64/
    enabled=1
    gpgcheck=1
    gpgkey=https://repo.amd.com/rocm/packages-multi-arch/gpg/rocm.gpg
    priority=50
    EOF
    sudo dnf clean all
    
  2. Install the RVS package.

    sudo apt install amdrocm7-rvs
    
    sudo dnf install amdrocm7-rvs
    
  3. Complete the following post-installation step to set up your environment. Set ROCM_PATH to your ROCm Core SDK location.

    tee -a ~/.bashrc << EOF
    export ROCM_PATH=/opt/rocm
    export PATH=\$ROCM_PATH/extras-7/bin:\$ROCM_PATH/bin:\$PATH
    export LD_LIBRARY_PATH=\$ROCM_PATH/extras-7/lib:\$ROCM_PATH/lib:\$ROCM_PATH/lib/llvm/lib:\$LD_LIBRARY_PATH
    EOF
    
    source ~/.bashrc
    
    sudo tee /etc/profile.d/set-rocm-env.sh << EOF
    export ROCM_PATH=/opt/rocm
    export PATH=\$ROCM_PATH/extras-7/bin:\$ROCM_PATH/bin:\$PATH
    export LD_LIBRARY_PATH=\$ROCM_PATH/extras-7/lib:\$ROCM_PATH/lib:\$ROCM_PATH/lib/llvm/lib:\$LD_LIBRARY_PATH
    EOF
    
    sudo chmod +x /etc/profile.d/set-rocm-env.sh
    source /etc/profile.d/set-rocm-env.sh
    
  4. Verify your installation.

    rvs -g
    

Note

The ROCm repositories must be set up before installing RVS. This repository setup is part of the ROCm Core SDK installation.

Tarball installation#

Use the following steps to install RVS using a tarball on top of the ROCm Core SDK.

  1. Install system dependencies.

    sudo apt install libpci3 libnuma1
    
    sudo dnf install pciutils-libs numactl-libs
    
  2. Download the RVS tarball.

    wget https://repo.amd.com/rocm/rvs/tarball/amdrocm7-rvs-1.5.122-579-Linux.tar.gz
    
  3. Extract the tarball to the ROCm Extras location.

    Set ROCM_PATH to your ROCm Core SDK location, which varies depending on how you installed it. For example, if you installed the ROCm Core SDK using your Linux distribution’s package manager:

    sudo mkdir -p /opt/rocm/extras-7
    sudo tar -xzf amdrocm7-rvs-1.5.122-579-Linux.tar.gz -C /opt/rocm/extras-7
    
  4. Complete the following post-installation step to set up your environment. Set ROCM_PATH to your ROCm Core SDK location.

    tee -a ~/.bashrc << EOF
    export ROCM_PATH=/opt/rocm
    export PATH=\$ROCM_PATH/extras-7/bin:\$ROCM_PATH/bin:\$PATH
    export LD_LIBRARY_PATH=\$ROCM_PATH/extras-7/lib:\$ROCM_PATH/lib:\$ROCM_PATH/lib/llvm/lib:\$LD_LIBRARY_PATH
    EOF
    
    source ~/.bashrc
    
    sudo tee /etc/profile.d/set-rocm-env.sh << EOF
    export ROCM_PATH=/opt/rocm
    export PATH=\$ROCM_PATH/extras-7/bin:\$ROCM_PATH/bin:\$PATH
    export LD_LIBRARY_PATH=\$ROCM_PATH/extras-7/lib:\$ROCM_PATH/lib:\$ROCM_PATH/lib/llvm/lib:\$LD_LIBRARY_PATH
    EOF
    
    sudo chmod +x /etc/profile.d/set-rocm-env.sh
    source /etc/profile.d/set-rocm-env.sh
    
  5. Verify your installation.

    rvs -g