From 5702a7c14aa1128b7e26fafe11a23041e7a0810f Mon Sep 17 00:00:00 2001 From: Young Hui - AMD <145490163+yhuiYH@users.noreply.github.com> Date: Fri, 20 Sep 2024 11:18:38 -0400 Subject: [PATCH] adding SUSEConnect packages to SLES install, and fix FAQ typo (#290) * adding SUSEConnect packages to SLES install, and fix FAQ typo * make education repo install method similar to perl, for consistency * make the quick start reboot message stand out some more * clean up prerequisites for RHEL and SUSE --- docs/install/prerequisites.rst | 47 ++++++++++------------------------ docs/install/quick-start.rst | 9 ++++--- docs/reference/install-faq.rst | 6 ++--- 3 files changed, 22 insertions(+), 40 deletions(-) diff --git a/docs/install/prerequisites.rst b/docs/install/prerequisites.rst index a79c56f7..cc3256bc 100644 --- a/docs/install/prerequisites.rst +++ b/docs/install/prerequisites.rst @@ -67,48 +67,24 @@ your operating system to ensure you're able to download and install packages. Typically you can register by following the step-by-step user interface. If you need to register by command line, use the following commands: - .. datatemplate:nodata:: - - .. tab-set:: - - {% for os_release in config.html_context['rhel_release_version_numbers'] %} - - .. tab-item:: RHEL {{ os_release }} - - .. code-block:: shell - - subscription-manager register --username --password - subscription-manager attach --auto + .. code-block:: shell - {% endfor %} + subscription-manager register --username --password + subscription-manager attach --auto - More details about `registering for RHEL `_ + More details about `registering for RHEL `_ .. tab-item:: SUSE Linux Enterprise Server :sync: sle-tab Typically you can register by following the step-by-step user interface. If you need to register by command line, use the following commands: + + .. code-block:: shell - .. datatemplate:nodata:: - - .. tab-set:: - - {% for os_version in config.html_context['sles_version_numbers'] %} - {% set os_release, os_sp = os_version.split('.') %} - - .. tab-item:: SLES {{ os_version }} - - .. code-block:: shell - - SUSEConnect -r - SUSEConnect -p sle-module-desktop-applications/{{ os_version }}/x86_64 - SUSEConnect -p sle-module-development-tools/{{ os_version }}/x86_64 - SUSEConnect -p PackageHub/{{ os_version }}/x86_64 - - {% endfor %} + SUSEConnect -r - More details about `registering for SLES `_ + More details about `registering for SLES `_ Additional package repositories @@ -157,7 +133,7 @@ instructions specific to your distribution to add the necessary repositories. .. tab-item:: SUSE Linux Enterprise Server :sync: sle-tab - Add the Perl language and Education repositories. + Add a few modules with SUSEConnect, along with the Perl language and Education repositories. .. datatemplate:nodata:: @@ -170,8 +146,11 @@ instructions specific to your distribution to add the necessary repositories. .. code-block:: shell + SUSEConnect -p sle-module-desktop-applications/{{ os_version }}/x86_64 + SUSEConnect -p sle-module-development-tools/{{ os_version }}/x86_64 + SUSEConnect -p PackageHub/{{ os_version }}/x86_64 sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/perl/{{ os_version }}/devel:languages:perl.repo - sudo zypper addrepo https://download.opensuse.org/repositories/Education/{{ os_version }}/ Education + sudo zypper addrepo https://download.opensuse.org/repositories/Education/{{ os_version }}/Education.repo {% endfor %} diff --git a/docs/install/quick-start.rst b/docs/install/quick-start.rst index e6ef8989..4c9e543c 100644 --- a/docs/install/quick-start.rst +++ b/docs/install/quick-start.rst @@ -10,7 +10,7 @@ Quick start installation guide This topic provides basic installation instructions for ROCm on Linux using your distribution’s native package manager. Before you begin, you should confirm your :ref:`kernel version ` matches the :ref:`ROCm system requirements `. -Once you do, review your required installation instructions by selecting your operating system and version, and then run the provided commands in your terminal. +Once you do, review your required installation instructions by selecting your operating system and version, and then run the provided commands in your terminal. The commands include the installation of the prerequisites, along with installing ROCm. For more in-depth installation instructions, refer to :ref:`detailed-install-overview`. @@ -79,8 +79,11 @@ For more in-depth installation instructions, refer to :ref:`detailed-install-ove :substitutions: sudo zypper update + SUSEConnect -p sle-module-desktop-applications/{{ os_version }}/x86_64 + SUSEConnect -p sle-module-development-tools/{{ os_version }}/x86_64 + SUSEConnect -p PackageHub/{{ os_version }}/x86_64 sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/{{ os_version}}/devel:languages:perl.repo - sudo zypper addrepo https://download.opensuse.org/repositories/Education/{{ os_version }}/ Education + sudo zypper addrepo https://download.opensuse.org/repositories/Education/{{ os_version }}/Education.repo sudo zypper install kernel-default-devel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/sle/{{ os_version }}/amdgpu-install-|amdgpu_install_version|.noarch.rpm @@ -88,7 +91,7 @@ For more in-depth installation instructions, refer to :ref:`detailed-install-ove sudo zypper install amdgpu-dkms rocm {% endfor %} -.. note:: +.. important:: To apply all settings, reboot your system. diff --git a/docs/reference/install-faq.rst b/docs/reference/install-faq.rst index 56a8e2ea..568f80e2 100644 --- a/docs/reference/install-faq.rst +++ b/docs/reference/install-faq.rst @@ -128,9 +128,9 @@ Docker images often come with minimal installations, meaning some essential pack zypper install sudo wget SUSEConnect SUSEConnect -r - SUSEConnect -p sle-module-desktop-application/15.4/x86_64 - SUSEConnect -p sle-module-development-tools/15.4/x86_64 - SUSEConnect -p PackageHub/15.4/x86_64 + SUSEConnect -p sle-module-desktop-applications/15.5/x86_64 + SUSEConnect -p sle-module-development-tools/15.5/x86_64 + SUSEConnect -p PackageHub/15.5/x86_64 After installing these packages and :ref:`registering using your license for Enterprise Linux ` (if applicable), install ROCm following the :doc:`Quick start installation guide <../install/quick-start>` in your Docker container.