Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding SUSEConnect packages to SLES install, and fix FAQ typo #290

Merged
merged 4 commits into from
Sep 20, 2024
Merged

adding SUSEConnect packages to SLES install, and fix FAQ typo #290

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9a72a80
adding SUSEConnect packages to SLES install, and fix FAQ typo
yhuiYH Sep 10, 2024
30384a5
make education repo install method similar to perl, for consistency
yhuiYH Sep 12, 2024
994b02f
make the quick start reboot message stand out some more
yhuiYH Sep 13, 2024
43ba99c
clean up prerequisites for RHEL and SUSE
yhuiYH Sep 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 13 additions & 34 deletions docs/install/prerequisites.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <username> --password <password>
subscription-manager attach --auto
.. code-block:: shell

{% endfor %}
subscription-manager register --username <username> --password <password>
subscription-manager attach --auto

More details about `registering for RHEL <https://access.redhat.com/solutions/253273>`_
More details about `registering for RHEL <https://access.redhat.com/solutions/253273>`_

.. 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 <REGCODE>
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 <REGCODE>

More details about `registering for SLES <https://www.suse.com/support/kb/doc/?id=000018564>`_
More details about `registering for SLES <https://www.suse.com/support/kb/doc/?id=000018564>`_


Additional package repositories
Expand Down Expand Up @@ -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::

Expand All @@ -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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You don't need the ".repo" on the end. What this command does is it adds the .repo file to /etc/zypp/repos.d. With the .repo at the end, it will add another .repo to the file since zypper automatically adds the .repo anyway. So, you actually get "Education.repo.repo", running this command. That being say, it will still work correctly anyway.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I sync'd with @dbieleck and we confirmed the ".repo.repo" doesn't occur with the instructions in this PR. There was a typo in his check. So we shall leave the instructions, as in, in this PR for SUSE install.


{% endfor %}

Expand Down
9 changes: 6 additions & 3 deletions docs/install/quick-start.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <verify_kernel_version>` matches the :ref:`ROCm system requirements <supported_distributions>`.

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`.

Expand Down Expand Up @@ -79,16 +79,19 @@ 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
sudo zypper refresh
sudo zypper install amdgpu-dkms rocm
{% endfor %}

.. note::
.. important::

To apply all settings, reboot your system.

Expand Down
6 changes: 3 additions & 3 deletions docs/reference/install-faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,9 +128,9 @@ Docker images often come with minimal installations, meaning some essential pack

zypper install sudo wget SUSEConnect
SUSEConnect -r <REGCODE>
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 <register-enterprise-linux>` (if applicable), install ROCm following the :doc:`Quick start installation guide <../install/quick-start>` in your Docker container.

Expand Down
Loading