diff --git a/docs/install/amdgpu-install.rst b/docs/install/amdgpu-install.rst index a8442d88..60a18e78 100644 --- a/docs/install/amdgpu-install.rst +++ b/docs/install/amdgpu-install.rst @@ -285,20 +285,15 @@ After uninstalling ROCm, remove the amdgpu-install package from system. Ubuntu -------------------------------------------------------------------- -.. code-block:: bash - - .. code-block:: bash +.. tab-set:: - sudo apt purge amdgpu-install - sudo apt autoremove - - .. tab-item:: Debian + .. tab-item:: Ubuntu .. code-block:: bash sudo apt purge amdgpu-install sudo apt autoremove - + .. tab-item:: RHEL .. code-block:: bash @@ -337,22 +332,6 @@ Remove ROCm and AMDGPU repositories # Restart the system sudo reboot - - .. tab-item:: Debian - - .. code-block:: bash - - # Remove the repositories - sudo rm /etc/apt/sources.list.d/amdgpu.list - sudo rm /etc/apt/sources.list.d/rocm.list - - # Clear cache and clean system - sudo rm -rf /var/cache/apt/* - sudo apt clean all - sudo apt update - - # Restart the system - sudo reboot .. tab-item:: RHEL diff --git a/docs/install/native-install/debian.rst b/docs/install/native-install/debian.rst deleted file mode 100644 index e134d675..00000000 --- a/docs/install/native-install/debian.rst +++ /dev/null @@ -1,173 +0,0 @@ -.. meta:: - :description: Debian native installation - :keywords: ROCm install, installation instructions, Debian, Debian native installation, AMD, ROCm - -**************************************************************************** -Debian native installation -**************************************************************************** - -.. important:: - - Ensure that the :doc:`/install/prerequisites` are met before installing. - -.. _debian-register-repo: - -Registering ROCm repositories -================================================= - -.. _debian-package-key: - -Package signing key ---------------------------------------------------------------------------- - -Download and convert the package signing key. - -.. code-block:: bash - - # Make the directory if it doesn't exist yet. - # This location is recommended by the distribution maintainers. - sudo mkdir --parents --mode=0755 /etc/apt/keyrings - - # Download the key, convert the signing-key to a full - # keyring required by apt and store in the keyring directory - wget https://repo.radeon.com/rocm/rocm.gpg.key -O - | \ - gpg --dearmor | sudo tee /etc/apt/keyrings/rocm.gpg > /dev/null - -.. _debian-register-driver: - -.. note:: - - The GPG key may change; ensure it is updated when installing a new release. - If the key signature verification fails while updating, - re-add the key from the ROCm to the apt repository as mentioned above. - -Register kernel-mode driver ---------------------------------------------------------------------------- - -Add the AMDGPU repository for the driver. - -.. datatemplate:nodata:: - - .. tab-set:: - {% for (os_version, os_release) in config.html_context['debian_version_numbers'] %} - .. tab-item:: Debian {{ os_version }} - :sync: debian-{{ os_version}} - - .. code-block:: bash - :substitutions: - - echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/|rocm_version|/ubuntu {{ os_release }} main" \ - | sudo tee /etc/apt/sources.list.d/amdgpu.list - sudo apt update - {% endfor %} - -.. _debian-register-rocm: - -Register ROCm packages ---------------------------------------------------------------------------- - -Add the ROCm repository. - -.. datatemplate:nodata:: - - .. tab-set:: - {% for (os_version, os_release) in config.html_context['debian_version_numbers'] %} - .. tab-item:: Debian {{ os_version }} - :sync: debian-{{ os_version}} - - .. code-block:: bash - :substitutions: - - echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/|rocm_version| {{ os_release }} main" \ - | sudo tee --append /etc/apt/sources.list.d/rocm.list - echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \ - | sudo tee /etc/apt/preferences.d/rocm-pin-600 - sudo apt update - {% endfor %} - -.. _debian-install: - -Installing -================================================ - -Install kernel driver ---------------------------------------------------------------------------- - -.. code-block:: bash - - sudo apt install amdgpu-dkms - sudo reboot - -Install ROCm packages ---------------------------------------------------------------------------- - -.. code-block:: bash - - sudo apt install rocm - -Complete the :doc:`../post-install`. - - -.. _debian-upgrade: - -Upgrading -================================================ - -To upgrade an existing ROCm installation to a newer version, follow the steps in -:ref:`debian-register-repo` and :ref:`debian-install`. - -.. note:: - - Upgrading the kernel driver may also upgrade the GPU firmware, which requires a - system reboot to take effect. - -.. _debian-uninstall: - -Uninstalling -================================================ - -Uninstall specific meta packages ---------------------------------------------------------------------------- - -.. code-block:: bash - :substitutions: - - # sudo apt autoremove - # For example: - sudo apt autoremove rocm - # Or for version specific packages: - sudo apt autoremove rocm|rocm_version| - -Uninstall ROCm packages ---------------------------------------------------------------------------- - -.. code-block:: bash - :substitutions: - - sudo apt autoremove rocm-core - # Or for version specific packages: - sudo apt autoremove rocm-core|rocm_version| - -Uninstall kernel-mode driver ---------------------------------------------------------------------------- - -.. code-block:: bash - - sudo apt autoremove amdgpu-dkms - -Remove ROCm and AMDGPU repositories ---------------------------------------------------------------------------- - -.. code-block:: bash - - # Remove the repositories - sudo rm /etc/apt/sources.list.d/rocm.list - sudo rm /etc/apt/sources.list.d/amdgpu.list - - # Clear the cache and clean the system - sudo rm -rf /var/cache/apt/* - sudo apt clean all - sudo apt update - - # Restart the system - sudo reboot