1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/microshift-updates-rhde-config-rhel-repos.adoc
2025-10-13 12:54:42 -04:00

71 lines
3.0 KiB
Plaintext

// Module included in the following assemblies:
//
//microshift_updating/microshift-update-options.adoc
:_mod-docs-content-type: PROCEDURE
[id="microshift-updates-rhde-config-rhel-repos_{context}"]
= Keeping {microshift-short} and {op-system-base} in a supported configuration
[role="_abstract"]
When using RPM updates, avoid creating an unsupported configuration or breaking your node by carefully managing your {op-system-base} repositories.
.Prerequisites
* You understand the support status of the version of {microshift-short} you are using.
* You have root-user access to your build host.
* You reviewed the link:https://docs.redhat.com/en/documentation/red_hat_build_of_microshift/{ocp-version}/html/getting_ready_to_install_microshift/microshift-install-get-ready#get-ready-install-rhde-compatibility-table_microshift-install-get-ready[{op-system-bundle} release compatibility matrix].
.Procedure
. Avoid unintended updates by locking your operating system version by running the following command:
+
[source,terminal,subs="attributes+"]
----
$ sudo subscription-manager release --set={op-system-version}
----
. If you are using an EUS {microshift-short} release, disable the {op-system-base} standard-support-scope repositories by running the following command:
+
[source,terminal,subs="attributes+"]
----
$ sudo subscription-manager repos \
--disable=rhel-{op-system-version-major}-for-$(uname -m)-appstream-rpms \ # <1>
--disable=rhel-{op-system-version-major}-for-$(uname -m)-baseos-rpms
----
<1> You can replace _{op-system-version-major}_ with the major version of your compatible {op-system-base} system if it is not same version given in this example.
. After you disable the standard-support repositories, enable the {op-system-base} EUS repos by running the following command:
+
[source,terminal,subs="attributes+"]
----
$ sudo subscription-manager repos \
--enable rhel-{op-system-version-major}-for-$(uname -m)-appstream-eus-rpms \ # <1>
--enable rhel-{op-system-version-major}-for-$(uname -m)-baseos-eus-rpms
----
<1> You can replace _{op-system-version-major}_ with the major version of your compatible {op-system-base} system if it is not same version given in this example.
.Verification
* List the repositories you have enabled for {op-system-base} by running the following command:
+
[source,terminal]
----
$ sudo subscription-manager repos --list-enabled
----
+
.Example output
+
[source,terminal]
----
+----------------------------------------------------------+
Available Repositories in /etc/yum.repos.d/redhat.repo
+----------------------------------------------------------+
Repo ID: rhel-9-for-x86_64-baseos-eus-rpms
Repo Name: Red Hat Enterprise Linux 9 for x86_64 - BaseOS - Extended Update Support (RPMs)
Repo URL: https://cdn.redhat.com/content/eus/rhel9/$releasever/x86_64/baseos/os
Enabled: 1
Repo ID: rhel-9-for-x86_64-appstream-eus-rpms
Repo Name: Red Hat Enterprise Linux 9 for x86_64 - AppStream - Extended Update Support (RPMs)
Repo URL: https://cdn.redhat.com/content/eus/rhel9/$releasever/x86_64/appstream/os
Enabled: 1
----