From 9a72a80a7316b59cf52ec5fadbd2a6d8b5ae0356 Mon Sep 17 00:00:00 2001 From: Young Hui Date: Tue, 10 Sep 2024 17:29:11 -0400 Subject: [PATCH 1/4] adding SUSEConnect packages to SLES install, and fix FAQ typo --- docs/install/quick-start.rst | 5 ++++- docs/reference/install-faq.rst | 6 +++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/install/quick-start.rst b/docs/install/quick-start.rst index e6ef8989..8f009569 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,6 +79,9 @@ 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 install kernel-default-devel 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. From 30384a50a7b3548b7970b5a641e5a75ce9e0c1fd Mon Sep 17 00:00:00 2001 From: Young Hui Date: Thu, 12 Sep 2024 13:29:43 -0400 Subject: [PATCH 2/4] make education repo install method similar to perl, for consistency --- docs/install/prerequisites.rst | 2 +- docs/install/quick-start.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/install/prerequisites.rst b/docs/install/prerequisites.rst index a79c56f7..315c7434 100644 --- a/docs/install/prerequisites.rst +++ b/docs/install/prerequisites.rst @@ -171,7 +171,7 @@ instructions specific to your distribution to add the necessary repositories. .. code-block:: shell 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 8f009569..7ff97b3d 100644 --- a/docs/install/quick-start.rst +++ b/docs/install/quick-start.rst @@ -83,7 +83,7 @@ For more in-depth installation instructions, refer to :ref:`detailed-install-ove 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 From 994b02f4165b6f51355a14b02da8130f2111ed29 Mon Sep 17 00:00:00 2001 From: Young Hui Date: Fri, 13 Sep 2024 14:51:38 -0400 Subject: [PATCH 3/4] make the quick start reboot message stand out some more --- docs/install/quick-start.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/quick-start.rst b/docs/install/quick-start.rst index 7ff97b3d..4c9e543c 100644 --- a/docs/install/quick-start.rst +++ b/docs/install/quick-start.rst @@ -91,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. From 43ba99c5addc85e78c5508fa6c2732ecb392357d Mon Sep 17 00:00:00 2001 From: Young Hui Date: Thu, 19 Sep 2024 23:41:00 -0400 Subject: [PATCH 4/4] clean up prerequisites for RHEL and SUSE --- docs/install/prerequisites.rst | 45 +++++++++------------------------- 1 file changed, 12 insertions(+), 33 deletions(-) diff --git a/docs/install/prerequisites.rst b/docs/install/prerequisites.rst index 315c7434..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,6 +146,9 @@ 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.repo