{"id":18711129,"url":"https://github.com/rocm/rocmvalidationsuite","last_synced_at":"2025-04-05T06:09:34.286Z","repository":{"id":33416055,"uuid":"131035337","full_name":"ROCm/ROCmValidationSuite","owner":"ROCm","description":"A system validation and diagnostics tool for monitoring, stress testing, detecting, and troubleshooting issues impacting AMD GPUs in high-performance computing environments","archived":false,"fork":false,"pushed_at":"2025-03-26T10:30:14.000Z","size":9115,"stargazers_count":67,"open_issues_count":14,"forks_count":41,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-03-29T05:09:42.784Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://rocm.docs.amd.com/projects/ROCmValidationSuite/en/latest/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ROCm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-25T16:34:29.000Z","updated_at":"2025-03-25T07:18:27.000Z","dependencies_parsed_at":"2023-11-29T10:31:10.229Z","dependency_job_id":"7e626858-6866-4baa-8f3c-2b1cc6f44f3a","html_url":"https://github.com/ROCm/ROCmValidationSuite","commit_stats":{"total_commits":1527,"total_committers":48,"mean_commits":31.8125,"dds":0.7740667976424361,"last_synced_commit":"75d5490e2c012544800dc584cc4c96019f88010c"},"previous_names":["rocm/rocmvalidationsuite","rocm-developer-tools/rocmvalidationsuite"],"tags_count":91,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ROCm%2FROCmValidationSuite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ROCm%2FROCmValidationSuite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ROCm%2FROCmValidationSuite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ROCm%2FROCmValidationSuite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ROCm","download_url":"https://codeload.github.com/ROCm/ROCmValidationSuite/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294541,"owners_count":20915340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T12:37:12.728Z","updated_at":"2025-04-05T06:09:34.268Z","avatar_url":"https://github.com/ROCm.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ROCmValidationSuite\nThe ROCm Validation Suite (RVS) is a system validation and diagnostics tool for monitoring, stress testing, detecting and troubleshooting issues that affects the functionality and performance of AMD GPU(s) operating in a high-performance/AI/ML computing environment. RVS is enabled using the ROCm software stack on a compatible software and hardware platform.\n\nRVS is a collection of tests, benchmarks and qualification tools each targeting a specific sub-system of the ROCm platform. All of the tools are implemented in software and share a common command line interface. Each set of tests are implemented in a “module” which is a library encapsulating the functionality specific to the tool. The CLI can specify the directory containing modules to use when searching for libraries to load. Each module may have a set of options that it defines and a configuration file that supports its execution.\n\nFor different RVS modules and their description, refer to [the documentation on features](./FEATURES.md).\n\nFor module configuration files description and examples, refer to [the user guide](./docs/ug1main.md).\n\n## Prerequisites\nPlease do this before compilation/installing compiled package.\n\nUbuntu :\n\n    sudo apt-get -y update \u0026\u0026 sudo apt-get install -y libpci3 libpci-dev doxygen unzip cmake git libyaml-cpp-dev\n\nCentOS :\n\n    sudo yum install -y cmake3 doxygen pciutils-devel rpm rpm-build git gcc-c++ yaml-cpp-devel\n\nRHEL :\n\n    sudo yum install -y cmake3 doxygen rpm rpm-build git gcc-c++ yaml-cpp-devel pciutils-devel\n\nSLES :\n\n    sudo zypper install -y cmake doxygen pciutils-devel libpci3 rpm git rpm-build gcc-c++ yaml-cpp-devel\n\n## Install ROCm stack, rocblas and rocm-smi-lib\nInstall ROCm stack for Ubuntu/CentOS/SLES/RHEL. Refer to\n [ROCm installation guide](https://rocmdocs.amd.com/en/latest/Installation_Guide/Installation-Guide.html) for more details.\n\n_**Note:**_\n\nrocm_smi64 package has been renamed to rocm-smi-lib64 from \u003e= ROCm3.0. If you are using ROCm release \u003c 3.0 , install the package as \"rocm_smi64\".\nrocm-smi-lib64 package has been renamed to rocm-smi-lib from \u003e= ROCm4.1.\n\nInstall rocBLAS and rocm-smi-lib :\n\nUbuntu :\n\n    sudo apt-get install rocblas rocm-smi-lib\n\nCentOS \u0026 RHEL :\n\n    sudo yum install --nogpgcheck rocblas rocm-smi-lib\n\nSUSE :\n\n    sudo zypper install rocblas rocm-smi-lib\n\n_**Note:**_\nIf rocm-smi-lib is already installed but /opt/rocm/lib/librocm_smi64.so doesn't exist. Do below:\n\nUbuntu :\n\n    sudo dpkg -r rocm-smi-lib \u0026\u0026 sudo apt install rocm-smi-lib\n\nCentOS \u0026 RHEL :\n\n    sudo rpm -e  rocm-smi-lib \u0026\u0026 sudo yum install  rocm-smi-lib\n\nSUSE :\n\n    sudo rpm -e  rocm-smi-lib \u0026\u0026 sudo zypper install  rocm-smi-lib\n\n## Building from Source\nThis section explains how to get and compile current development stream of RVS.\n\n### Clone repository\n\n    git clone https://github.com/ROCm/ROCmValidationSuite.git\n\n### Configure:\n\n    cd ROCmValidationSuite\n    cmake -B ./build -DROCM_PATH=\u003crocm_installed_path\u003e -DCMAKE_INSTALL_PREFIX=\u003crocm_installed_path\u003e -DCPACK_PACKAGING_INSTALL_PREFIX=\u003crocm_installed_path\u003e\n\n    e.g. If ROCm 5.5 was installed,\n    cmake -B ./build -DROCM_PATH=/opt/rocm-5.5.0 -DCMAKE_INSTALL_PREFIX=/opt/rocm-5.5.0 -DCPACK_PACKAGING_INSTALL_PREFIX=/opt/rocm-5.5.0\n\n### Build binary:\n\n    make -C ./build\n\n### Build package:\n\n    cd ./build\n    make package\n\n**Note:**_ based on your OS, only DEB or RPM package will be built. You may\nignore an error for the unrelated configuration\n\n### Install built package:\n\nUbuntu :\n\n    sudo dpkg -i rocm-validation-suite*.deb\n\nCentOS \u0026 RHEL \u0026 SUSE :\n\n    sudo rpm -i --replacefiles --nodeps rocm-validation-suite*.rpm\n\n**Note:**\nRVS is getting packaged as part of ROCm release starting from 3.0. You can install pre-compiled package as below.\nPlease make sure Prerequisites, ROCm stack, rocblas and rocm-smi-lib64 are already installed\n\n### Install package packaged with ROCm release:\n\nUbuntu :\n\n    sudo apt install rocm-validation-suite\n\nCentOS \u0026 RHEL :\n\n    sudo yum install rocm-validation-suite\n\nSUSE :\n\n    sudo zypper install rocm-validation-suite\n\n## Running RVS\n\n### Run version built from source code\n\n    cd \u003csource folder\u003e/build/bin\n\n    Command examples\n    ./rvs --help ; Lists all options to run RVS test suite\n    ./rvs -g ; Lists supported GPUs available in the machine\n    ./rvs -c conf/gst_single.conf ; Run GST module default test configuration\n\n### Run version pre-compiled and packaged with ROCm release\n\n    cd /opt/rocm/bin\n\n    Command examples\n    ./rvs --help ; Lists all options to run RVS test suite\n    ./rvs -g ; Lists supported GPUs available in the machine\n    ./rvs -c ../share/rocm-validation-suite/conf/gst_single.conf ; Run GST default test configuration\n\nTo run GPU specific test configuration, use configuration files from GPU folders in \"/opt/rocm/share/rocm-validation-suite/conf\"\n\n    ./rvs -c ../share/rocm-validation-suite/conf/MI300X/gst_single.conf ; Run MI300X specific GST test configuration\n    ./rvs -c ../share/rocm-validation-suite/conf/nv32/gst_single.conf ; Run Navi 32 specific GST test configuration\n\nNote: If present, always use GPU specific configurations instead of default test configurations.\n\n## Reporting\n\nTest results, errors and verbose logs are printed as terminal output. To enable json logging use \"-j\" command line option.\nThe json output file path can be specified after \"-j\" option. If not specified, a file is created in /var/tmp folder and the name of the file will be printed to stdout. The json file schemas are documented at [schemas](./docs/schemas)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frocm%2Frocmvalidationsuite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frocm%2Frocmvalidationsuite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frocm%2Frocmvalidationsuite/lists"}