Install rocSHMEM#

Before you begin, verify that your system is supported. For more information, see ROCm Core SDK components.

For advanced workflows, source builds, or custom configurations, see Build rocSHMEM from source.

Install the ROCm Core SDK#

rocSHMEM is included with the ROCm Core SDK on Linux. For the most complete installation, we recommend that developers use the amdrocm-core-sdk meta package.

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

Install rocSHMEM on Linux#

Alternatively, if you want to install rocSHMEM without additional ROCm libraries and tools, install the amdrocm-rocshmem package. This package includes rocSHMEM and base ROCm packages.

  1. Complete the ROCm installation prerequisites to install dependencies and configure GPU access permissions.

  2. Install the rocSHMEM package that matches your ROCm version and development package needs. Package names use the following format:

    amdrocm-rocshmem-<dev/devel><rocm_version>
    

    Where:

    • <dev/devel> specifies whether to the install library files and headers. Omit this suffix to only install runtime packages.

      • -dev is used on Debian-based distributions, including Ubuntu.

      • -devel is used on RPM-based distributions, including RHEL and SLES.

    • <rocm_version> is the ROCm Core SDK version to install. Omit this suffix to install the latest available version.

    For example, to install the latest rocSHMEM development package release for supported GPU architectures:

    sudo apt install amdrocm-rocshmem-dev
    
    sudo dnf install amdrocm-rocshmem-devel
    
    sudo zypper install amdrocm-rocshmem-devel
    

Install a nightly build#

The TheRock build system also publishes nightly builds for the ROCm Core SDK and its components, including rocSHMEM. See Nightly release status for details.