Post-installation instructions

Post-installation instructions#

2024-12-19

3 min read time

Applies to Linux

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.1/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

    apt list --installed

    dnf list installed

    dnf list installed

    zypper search --installed-only