Post-installation instructions

Post-installation instructions#

Applies to Linux

2024-11-21

3 min read time

After installing ROCm, follow these steps to finalize and validate the installation.

  1. Configure the system linker by indicating where to find the shared objects (.so files) for the ROCm applications.

    sudo tee --append /etc/ld.so.conf.d/rocm.conf <<EOF
    /opt/rocm/lib
    /opt/rocm/lib64
    EOF
    sudo ldconfig
    
  2. Configure the path to the ROCm binary using either the update-alternatives or environment-modules Linux utilities. The ROCm installation process adds the ROCm executables to these systems, provided they are installed on the system.

    • update-alternatives:

      The update-alternatives utility is available on most Linux distributions. It helps manage multiple versions of a command or program. For more information about update-alternatives, see the Linux man page.

      To use update-alternatives, follow these steps:

      1. List all the ROCm commands that are supported:

        update-alternatives --list rocm
        
      2. If you have installed multiple ROCm versions, update-alternatives is automatically configured to use the latest version. To switch between installed versions, use this command:

        update-alternatives --config rocm
        
    • environment-modules:

      The environment-modules tool simplifies shell initialization. It lets you modify your session environment using module files. For more information, see the Environment Modules documentation.

      To use environment-modules, follow these instructions:

      1. List the ROCm versions that are available:

        module avail
        
      2. If multiple ROCm versions are installed, switch between them using this command:

        module load rocm/<version>
        

    Note

    The ROCm module file is located at /opt/rocm-<ver>/lib/rocmmod.

    If update-alternatives isn’t available on the system, set the PATH variable to /opt/rocm-<ver>/bin.

    export PATH=$PATH:/opt/rocm-6.3.0/bin
    
  1. Verify the kernel-mode driver installation.

    dkms status
    
  2. Export LD_LIBRARY_PATH as needed

    Important

    This step is required for version specific or multi-version installations.

    export LD_LIBRARY_PATH=/opt/rocm-6.3.0/lib
    
  3. Verify the ROCm installation.

    rocminfo
    clinfo
    
  4. Verify the package installation.

    apt list --installed
    
    dnf list installed
    
    dnf list installed
    
    zypper search --installed-only