Skip to content

Commit cadb3ec

Browse files
Merge pull request #10563 from msaenzbosupport/patch-50
AB#9467: Update RHUI package details for RHEL 10 support
2 parents b641e5e + e4f17eb commit cadb3ec

2 files changed

Lines changed: 174 additions & 17 deletions

File tree

support/azure/virtual-machines/linux/troubleshoot-linux-rhui-certificate-issues.md

Lines changed: 159 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ ms.custom: sap:VM Admin - Linux (Guest OS), linux-related-content
1414

1515
**Applies to:** :heavy_check_mark: Linux VMs
1616

17+
## Summary
18+
1719
This article discusses common issues in the Red Hat Update Infrastructure (RHUI) that are caused by expired or missing Transport Layer Security (TLS) or Secure Sockets Layer (SSL) certificates.
1820

1921
## Prerequisites
@@ -154,12 +156,12 @@ Use the following table to determine the correct RHUI package type based on your
154156
| Image type | Support model | Applicable version | RHUI package prefix | Using `releasever`? |
155157
|--------------------|---------------------------|----------------------------------------------|------------------------------------|-------------------------|
156158
| Generic RHEL | Non-EUS | 7.9, 8.10, 9.8, 10.0 | `rhui-azure-rhelX` | No |
157-
| Generic RHEL | EUS | 8.6, 8.8, 9.2, 9.4, 9.6 | `rhui-azure-rhelX-eus` | Yes |
158-
| RHEL-SAP-APPS | EUS | 8.6, 8.8, 9.2, 9.4, 9.6 | `rhui-azure-rhelX-sapapps` | Yes |
159+
| Generic RHEL | EUS | 9.4, 9.6, 10.0 | `rhui-azure-rhelX-eus` | Yes |
160+
| RHEL-SAP-APPS | EUS | 8.6, 8.8, 9.2, 9.4, 9.6, 10.0 | `rhui-azure-rhelX-sapapps` | Yes |
159161
| RHEL-SAP-APPS | Base (no EUS available) | 7.9, 8.10 | `rhui-azure-rhelX-base-sap-apps` | No |
160-
| RHEL-SAP-HA | E4S | 8.6, 8.8, 9.2, 9.4, 9.6 | `rhui-azure-rhelX-sap-ha` | Yes |
162+
| RHEL-SAP-HA | E4S | 8.6, 8.8, 9.2, 9.4, 9.6, 10.0 | `rhui-azure-rhelX-sap-ha` | Yes |
161163
| RHEL-SAP-HA | Base (no E4S available) | 7.9, 8.10 | `rhui-azure-rhelX-base-sap-ha` | No |
162-
| RHEL-HA | EUS | 8.6, 8.8, 9.4, 9.6 | `rhui-azure-rhelX-ha` | Yes |
164+
| RHEL-HA | EUS | 8.6, 8.8, 9.4, 9.6, 10.0 | `rhui-azure-rhelX-ha` | Yes |
163165
| RHEL-HA | Base (no EUS available) | 7.9, 8.10 | `rhui-azure-rhelX-base-ha` | No |
164166

165167
> [!NOTE]
@@ -177,6 +179,7 @@ Use the following index to navigate directly to the corresponding section:
177179
- [RHEL 7 SAP RHUI package installation](#rhel79sap)
178180
- [RHEL 8 SAP/E4S/HA RHUI package installation](#rhel8sap)
179181
- [RHEL 9 SAP/E4S/HA RHUI package installation](#rhel9sap)
182+
- [RHEL 10 SAP/E4S/HA RHUI package installation](#rhel10sap)
180183

181184

182185
##### <a id="eus"></a> EUS RHUI package installation
@@ -252,6 +255,41 @@ Select the tab of an EUS image type to see the corresponding instructions.
252255
sudo rhel9-eus.config
253256
```
254257
258+
###### [RHEL 10.x - EUS](#tab/rhel10-eus)
259+
260+
261+
262+
1. Create a config file by using this command:
263+
264+
```bash
265+
sudo tee rhel10-eus.config > /dev/null <<< $'[rhui-microsoft-azure-rhel10-eus]\nname=Microsoft Azure RPMs for Red Hat Enterprise Linux 10 (rhel10-eus)\nbaseurl=https://rhui4-1.microsoft.com/pulp/repos/unprotected/microsoft-azure-rhel10-eus\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft-2025.asc\nsslverify=1'
266+
267+
```
268+
269+
2. Install the `rhui-azure-rhel10-eus` package by running.
270+
271+
```bash
272+
sudo dnf --config rhel10-eus.config install rhui-azure-rhel10-eus
273+
```
274+
275+
3. Lock the `releasever` variable:
276+
277+
```bash
278+
sudo echo $(. /etc/os-release && echo $VERSION_ID) > /etc/dnf/vars/releasever
279+
```
280+
281+
4. Verify that the corresponding repositories are available and show no errors. To do this, run the `dnf repolist` command:
282+
283+
```bash
284+
sudo dnf repolist all
285+
```
286+
287+
5. Remove the temp file created on step 1.
288+
289+
```bash
290+
sudo rhel10-eus.config
291+
```
292+
255293
---
256294
257295
@@ -818,6 +856,123 @@ The following steps apply if the OS version is *earlier than the latest version
818856
---
819857
820858
859+
> [!NOTE]
860+
> If you're using a proxy in */etc/yum.conf* or */etc/dnf.conf*, the `yum --config rhelX-XX-XX.config` command won't work because it doesn't include your proxy settings. In this case, move the temp file `rhelX-XX-XX.config` directly in `/etc/yum.repos.d/` as `.repo`
861+
>
862+
> ```bash
863+
> sudo mv rhelX-XX-XX.config /etc/yum.repos.d/ms.repo
864+
> sudo yum install rhui-azure-rhel-X-X-X
865+
> sudo rm rhelX-XX-XX.config
866+
> ```
867+
> Replace `rhelX-XX-XX.config` and `rhui-azure-rhel-X-X-X` with the actual values, as appropriate.
868+
869+
##### <a id="rhel10sap"></a> RHEL 10 SAP/E4S/HA RHUI package installation
870+
871+
Select the tab of an SAP image type to see the corresponding instructions.
872+
873+
###### [RHEL 10.x - RHEL-SAP-APPS](#tab/rhel10-rhel-sap-apps)
874+
875+
The following steps apply if the OS version is *earlier than the latest version that's available* that's supported by SAP for `RHEL 10.0`, and if the VM was created by using the `RHEL-SAP-APPS` offer image.
876+
877+
1. Create a config file by using this command:
878+
879+
```bash
880+
sudo tee rhel10-sapapps.config > /dev/null <<< $'[rhui-microsoft-azure-rhel10-sapapps]\nname=Microsoft Azure RPMs for Red Hat Enterprise Linux 10 (rhel10-sapapps)\nbaseurl=https://rhui4-1.microsoft.com/pulp/repos/unprotected/microsoft-azure-rhel10-sapapps\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft-2025.asc\nsslverify=1'
881+
```
882+
883+
2. Install the `rhui-azure-rhel10-sapapps` package by running the `dnf install` command:
884+
885+
```bash
886+
sudo dnf --config rhel10-sapapps.config install rhui-azure-rhel10-sapapps
887+
```
888+
889+
3. Lock the `releasever` level. Currently, the version must be 10.0.
890+
891+
```bash
892+
sudo sh -c 'echo 10.0 > /etc/dnf/vars/releasever'
893+
```
894+
895+
4. Verify that the corresponding repositories are available and show no errors. To do this, run the `yum repolist` command:
896+
897+
```bash
898+
sudo dnf repolist all
899+
```
900+
901+
5. Remove the temp file created on step 1.
902+
903+
```bash
904+
sudo rm rhel10-sapapps.config
905+
```
906+
907+
###### [RHEL 10.x - RHEL-SAP-HA (E4S)](#tab/rhel10-rhel-sap-ha-e4s)
908+
909+
The following steps apply if the OS version is *earlier than the latest version available* that's supported by SAP for `RHEL 10.0`, and if the VM was created by using the `RHEL-SAP-HA` offer image.
910+
911+
1. Create a config file by using this command:
912+
913+
```bash
914+
sudo tee rhel10-sap-ha.config > /dev/null <<< $'[rhui-microsoft-azure-rhel10-sap-ha]\nname=Microsoft Azure RPMs for Red Hat Enterprise Linux 10 (rhel10-sap-ha)\nbaseurl=https://rhui4-1.microsoft.com/pulp/repos/unprotected/microsoft-azure-rhel10-sap-ha\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft-2025.asc\nsslverify=1'
915+
```
916+
917+
2. Install the `rhui-azure-rhel10-sap-ha` package by running the `dnf install` command:
918+
919+
```bash
920+
sudo dnf --config rhel10-sap-ha.config install rhui-azure-rhel10-sap-ha
921+
```
922+
923+
3. Lock the `releasever` level. Currently, the version must be 10.0.
924+
925+
```bash
926+
sudo sh -c 'echo 10.0 > /etc/dnf/vars/releasever'
927+
```
928+
929+
4. Verify that the corresponding repositories are available and show no errors. To do this, run the `dnf repolist` command:
930+
931+
```bash
932+
sudo dnf repolist all
933+
```
934+
935+
5. Remove the temp file created on step 1.
936+
937+
```bash
938+
sudo rm rhel10-sap-ha.config
939+
```
940+
941+
###### [RHEL 10.x - RHEL-HA](#tab/rhel10-rhel-ha-eus)
942+
943+
1. Create a config file by using this command:
944+
945+
```bash
946+
sudo tee rhel10-ha.config > /dev/null <<< $'[rhui-microsoft-azure-rhel10-ha]\nname=Microsoft Azure RPMs for Red Hat Enterprise Linux 10 (rhel10-ha)\nbaseurl=https://rhui4-1.microsoft.com/pulp/repos/unprotected/microsoft-azure-rhel10-ha\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft-2025.asc\nsslverify=1'
947+
```
948+
949+
2. Install the `rhui-azure-rhel10-ha` package by running the [dnf](https://dnf.readthedocs.io/en/latest/command_ref.html) installation command:
950+
951+
```bash
952+
sudo dnf --config rhel10-ha.config install rhui-azure-rhel10-ha
953+
```
954+
955+
3. Lock the `releasever` level. Currently, the version must be 10.0.
956+
957+
```bash
958+
sudo sh -c 'echo 10.0 > /etc/dnf/vars/releasever'
959+
```
960+
961+
4. Verify that the corresponding repositories are available and show no errors. To do this, run the `dnf repolist` command:
962+
963+
```bash
964+
sudo dnf repolist
965+
```
966+
967+
5. Remove the temp file created on step 1.
968+
969+
```bash
970+
sudo rm rhel10-ha.config
971+
```
972+
973+
---
974+
975+
821976
> [!NOTE]
822977
> If you're using a proxy in */etc/yum.conf* or */etc/dnf.conf*, the `yum --config rhelX-XX-XX.config` command won't work because it doesn't include your proxy settings. In this case, move the temp file `rhelX-XX-XX.config` directly in `/etc/yum.repos.d/` as `.repo`
823978
>
@@ -929,5 +1084,3 @@ Revert the cryptography to the `DEFAULT` system policy setting by following thes
9291084
For more information about cryptographic policy, see [Strong crypto defaults in RHEL 8 and deprecation of weak crypto algorithms](https://access.redhat.com/articles/3642912).
9301085
9311086
[!INCLUDE [Third-party disclaimer](../../../includes/third-party-disclaimer.md)]
932-
933-

support/azure/virtual-machines/linux/yum-dnf-common-issues.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,8 @@ ms.date: 07/10/2025
1818

1919
**Applies to:** :heavy_check_mark: Linux VMs
2020

21+
## Summary
22+
2123
This article discusses and resolves common issues that you might experience when you use `yum` and `dnf` package management tools to install or update applications on Microsoft Azure virtual machines (VMs).
2224

2325
> [!CAUTION]
@@ -410,34 +412,36 @@ If the error typically occurs because an incorrect value is used for */etc/yum/v
410412

411413
2. Determine the current value for the release version by running the following `cat` command.
412414

413-
| RHEL version | Command |
414-
|--------------|-------------------------------------|
415-
| RHEL 7 | `sudo cat /etc/yum/vars/releasever` |
416-
| RHEL 8 and 9 | `sudo cat /etc/dnf/vars/releasever` |
415+
| RHEL version | Command |
416+
|----------------|-------------------------------------|
417+
| RHEL 7 | `sudo cat /etc/yum/vars/releasever` |
418+
| RHEL 8, and 10 | `sudo cat /etc/dnf/vars/releasever` |
417419

418420
3. Modify and use the correct value for the release version:
419421

420422
- If your system is using EUS repositories, make sure that the appropriate version lock is applied. In the following example, the version lock is added for RHEL 9.2 because `RHUI EUS` repositories are used:
421423

422424
```bash
423425
sudo sh -c 'echo 9.2 > /etc/dnf/vars/releasever'
426+
sudo sh -c 'echo 9.6 > /etc/dnf/vars/releasever'
424427
```
425428

426429
> [!NOTE]
427-
> Support for RHEL7 EUS ended on August 30, 2021. We recommend that you no longer use EUS repositories in RHEL7.
430+
> Support for RHEL 7 EUS ended on August 30, 2021. We recommend that you no longer use EUS repositories in RHEL 7.
428431
>
429-
> RHEL 8._x_ versions for EUS are available. These versions include RHEL 8.8, 8.6, 8.4, 8.2, and 8.1.
432+
> Support for RHEL 8 EUS ended on May 31, 2025. RHEL 8.10 is the last planned minor release of RHEL 8 and is still supported, but isn't an EUS release. We recommend that you no longer use EUS repositories in RHEL 8 and instead switch to the non-EUS repos.
430433
>
431-
> RHEL 9._x_ versions for EUS are available. Currently, these versions include RHEL 9.2 and 9.0.
434+
> RHEL 9._x_ versions for EUS are available. Currently, these versions include RHEL 9.6 and 9.4.
432435
>
436+
> RHEL 10._x_ versions for EUS are available. Currently, these versions include only RHEL 10.0.
433437
> For more information about version availability, see [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata).
434438

435439
- If your system is using non-EUS repositories, make sure that you remove the version lock for the */etc/yum/vars/releasever* or */etc/dnf/vars/releasever* file by running the following command.
436440

437-
| RHEL version | Command |
438-
|--------------|-------------------------------------------|
439-
| RHEL 7 | `sudo echo "" > /etc/yum/vars/releasever` |
440-
| RHEL 8 and 9 | `sudo echo "" > /etc/dnf/vars/releasever` |
441+
| RHEL version | Command |
442+
|-----------------|-------------------------------------------|
443+
| RHEL 7 | `sudo echo "" > /etc/yum/vars/releasever` |
444+
| RHEL 8,9 and 10 | `sudo echo "" > /etc/dnf/vars/releasever` |
441445

442446
##### [Oracle Linux](#tab/ol)
443447

0 commit comments

Comments
 (0)