// 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 \
    --disable=rhel-{op-system-version-major}-for-$(uname -m)-baseos-rpms
----
+
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 \
    --enable rhel-{op-system-version-major}-for-$(uname -m)-baseos-eus-rpms
----
+
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
----
