Post-installation instructions

Applies to Linux

2024-11-01

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.2.2/bin
   

3. Verify the kernel-mode driver installation.

   dkms status
   

4. Verify the ROCm installation.

   rocminfo
   clinfo
   

5. Verify the package installation.

   Ubuntu

   apt list --installed
   

   RHEL

   dnf list installed
   

   SLES

   zypper search --installed-only