Skip to content

Commit e53b17f

Browse files
authored
Merge pull request #232684 from msaenzbosupport/patch-7
[Doc-A-THon] Updating RHUI in Azure
2 parents 3af2c08 + dec9ba3 commit e53b17f

File tree

1 file changed

+37
-34
lines changed

1 file changed

+37
-34
lines changed

articles/virtual-machines/workloads/redhat/redhat-rhui.md

Lines changed: 37 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -40,35 +40,35 @@ Information on Red Hat support policies for all versions of RHEL can be found on
4040

4141
As of April 2019, Azure offers RHEL images that are connected to Extended Update Support (EUS) repositories by default and RHEL images that come connected to the regular (non-EUS) repositories by default. More details on RHEL EUS are available in Red Hat's [version lifecycle documentation](https://access.redhat.com/support/policy/updates/errata) and [EUS documentation](https://access.redhat.com/articles/rhel-eus). The default behavior of `sudo yum update` will vary depending which RHEL image you provisioned from, as different images are connected to different repositories.
4242

43-
For a full image list, run `az vm image list --publisher redhat --all` using the Azure CLI.
43+
For a full image list, run `az vm image list --offer RHEL --all -p RedHat --output table` using the Azure CLI.
4444

4545
### Images connected to non-EUS repositories
4646

4747
If you provision a VM from a RHEL image that is connected to non-EUS repositories, you will be upgraded to the latest RHEL minor version when you run `sudo yum update`. For example, if you provision a VM from an RHEL 7.4 PAYG image and run `sudo yum update`, you end up with an RHEL 7.8 VM (the latest minor version in the RHEL7 family).
4848

4949
Images that are connected to non-EUS repositories will not contain a minor version number in the SKU. The SKU is the third element in the URN (full name of the image). For example, all of the following images come attached to non-EUS repositories:
5050

51-
```text
52-
RedHat:RHEL:7-LVM:7.4.2018010506
53-
RedHat:RHEL:7-LVM:7.5.2018081518
54-
RedHat:RHEL:7-LVM:7.6.2019062414
55-
RedHat:RHEL:7-RAW:7.4.2018010506
56-
RedHat:RHEL:7-RAW:7.5.2018081518
57-
RedHat:RHEL:7-RAW:7.6.2019062120
51+
```output
52+
RedHat:RHEL:7-LVM:7.9.2023032012
53+
RedHat:RHEL:8-LVM:8.7.2023022813
54+
RedHat:RHEL:9-lvm:9.1.2022112101
55+
RedHat:rhel-raw:7-raw:7.9.2022040605
56+
RedHat:rhel-raw:8-raw:8.6.2022052413
57+
RedHat:rhel-raw:9-raw:9.1.2022112101
5858
```
5959

60-
Note that the SKUs are either 7-LVM or 7-RAW. The minor version is indicated in the version (fourth element in the URN) of these images.
60+
Note that the SKUs are either X-LVM or X-RAW. The minor version is indicated in the version (fourth element in the URN) of these images.
6161

6262
### Images connected to EUS repositories
6363

6464
If you provision a VM from a RHEL image that is connected to EUS repositories, you will not be upgraded to the latest RHEL minor version when you run `sudo yum update`. This is because the images connected to EUS repositories are also version-locked to their specific minor version.
6565

6666
Images connected to EUS repositories will contain a minor version number in the SKU. For example, all of the following images come attached to EUS repositories:
6767

68-
```text
69-
RedHat:RHEL:7.4:7.4.2019062107
70-
RedHat:RHEL:7.5:7.5.2019062018
71-
RedHat:RHEL:7.6:7.6.2019062116
68+
```output
69+
RedHat:RHEL:7_9:7.9.20230301107
70+
RedHat:RHEL:8_7:8.7.2023022801
71+
RedHat:RHEL:9_1:9.1.2022112113
7272
```
7373

7474
## RHEL EUS and version-locking RHEL VMs
@@ -83,6 +83,9 @@ At the time of this writing, EUS support has ended for RHEL <= 7.4. See the "Red
8383
* RHEL 7.5 EUS support ends April 30, 2020
8484
* RHEL 7.6 EUS support ends May 31, 2021
8585
* RHEL 7.7 EUS support ends August 30, 2021
86+
* RHEL 8.4 EUS support ends May 31, 2023
87+
* RHEL 8.6 EUS support ends May 31, 2024
88+
* RHEL 9.0 EUS support ends May 31, 2024
8689

8790
### Switch a RHEL VM 7.x to EUS (version-lock to a specific minor version)
8891
Use the following instructions to lock a RHEL 7.x VM to a particular minor release (run as root):
@@ -91,17 +94,17 @@ Use the following instructions to lock a RHEL 7.x VM to a particular minor relea
9194
> This only applies for RHEL 7.x versions for which EUS is available. At the time of this writing, this includes RHEL 7.2-7.7. More details are available at the [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata) page.
9295
1. Disable non-EUS repos:
9396
```bash
94-
yum --disablerepo='*' remove 'rhui-azure-rhel7'
97+
sudo yum --disablerepo='*' remove 'rhui-azure-rhel7'
9598
```
9699

97100
1. Add EUS repos:
98101
```bash
99-
yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel7-eus.config' install 'rhui-azure-rhel7-eus'
102+
sudo yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel7-eus.config' install 'rhui-azure-rhel7-eus'
100103
```
101104

102105
1. Lock the `releasever` variable (run as root):
103106
```bash
104-
echo $(. /etc/os-release && echo $VERSION_ID) > /etc/yum/vars/releasever
107+
sudo echo $(. /etc/os-release && echo $VERSION_ID) > /etc/yum/vars/releasever
105108
```
106109

107110
>[!NOTE]
@@ -118,28 +121,28 @@ Use the following instructions to lock a RHEL 8.x VM to a particular minor relea
118121
> This only applies for RHEL 8.x versions for which EUS is available. At the time of this writing, this includes RHEL 8.1-8.2. More details are available at the [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata) page.
119122
1. Disable non-EUS repos:
120123
```bash
121-
yum --disablerepo='*' remove 'rhui-azure-rhel8'
124+
sudo yum --disablerepo='*' remove 'rhui-azure-rhel8'
122125
```
123126

124127
1. Get the EUS repos config file:
125128
```bash
126-
wget https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel8-eus.config
129+
sudo wget https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel8-eus.config
127130
```
128131

129132
1. Add EUS repos:
130133
```bash
131-
yum --config=rhui-microsoft-azure-rhel8-eus.config install rhui-azure-rhel8-eus
134+
sudo yum --config=rhui-microsoft-azure-rhel8-eus.config install rhui-azure-rhel8-eus
132135
```
133136

134137
1. Lock the `releasever` variable (run as root):
135138
```bash
136-
echo $(. /etc/os-release && echo $VERSION_ID) > /etc/yum/vars/releasever
139+
sudo echo $(. /etc/os-release && echo $VERSION_ID) > /etc/yum/vars/releasever
137140
```
138141

139142
>[!NOTE]
140143
> The above instruction will lock the RHEL minor release to the current minor release. Enter a specific minor release if you are looking to upgrade and lock to a later minor release that is not the latest. For example, `echo 8.1 > /etc/yum/vars/releasever` will lock your RHEL version to RHEL 8.1.
141144
>[!NOTE]
142-
> If there are permission issues to access the releasever, you can edit the file using 'nano /etc/yum/vars/releaseve' and add the image version details and save ('Ctrl+o' then press enter and then 'Ctrl+x').
145+
> If there are permission issues to access the releasever, you can edit the file using your favorite editor and add the image version details and save it.
143146
1. Update your RHEL VM
144147
```bash
145148
sudo yum update
@@ -150,17 +153,17 @@ Use the following instructions to lock a RHEL 8.x VM to a particular minor relea
150153
Run the following as root:
151154
1. Remove the `releasever` file:
152155
```bash
153-
rm /etc/yum/vars/releasever
156+
sudo rm /etc/yum/vars/releasever
154157
```
155158

156159
1. Disable EUS repos:
157160
```bash
158-
yum --disablerepo='*' remove 'rhui-azure-rhel7-eus'
161+
sudo yum --disablerepo='*' remove 'rhui-azure-rhel7-eus'
159162
```
160163

161164
1. Configure RHEL VM
162165
```bash
163-
yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel7.config' install 'rhui-azure-rhel7'
166+
sudo yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel7.config' install 'rhui-azure-rhel7'
164167
```
165168

166169
1. Update your RHEL VM
@@ -172,22 +175,22 @@ Run the following as root:
172175
Run the following as root:
173176
1. Remove the `releasever` file:
174177
```bash
175-
rm /etc/yum/vars/releasever
178+
sudo rm /etc/yum/vars/releasever
176179
```
177180

178181
1. Disable EUS repos:
179182
```bash
180-
yum --disablerepo='*' remove 'rhui-azure-rhel8-eus'
183+
sudo yum --disablerepo='*' remove 'rhui-azure-rhel8-eus'
181184
```
182185

183186
1. Get the regular repos config file:
184187
```bash
185-
wget https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel8.config
188+
sudo wget https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel8.config
186189
```
187190

188191
1. Add non-EUS repos:
189192
```bash
190-
yum --config=rhui-microsoft-azure-rhel8.config install rhui-azure-rhel8
193+
sudo yum --config=rhui-microsoft-azure-rhel8.config install rhui-azure-rhel8
191194
```
192195

193196
1. Update your RHEL VM
@@ -202,7 +205,7 @@ RHUI is available in all regions where RHEL on-demand images are available. It c
202205
If you're using a network configuration to further restrict access from RHEL PAYG VMs, make sure the following IPs are allowed for `yum update` to work depending on the environment you're in:
203206

204207

205-
```
208+
```output
206209
# Azure Global
207210
RHUI 3
208211
13.91.47.76
@@ -218,7 +221,7 @@ eastus - 52.142.4.99
218221
australiaeast - 20.248.180.252
219222
southeastasia - 20.24.186.80
220223
221-
# Azure US Government (To be deprecated after 10th April 2023. For RHUI 4 conections, use public RHUI IPs as provided above)
224+
# Azure US Government (To be deprecated after 10th April 2023. For RHUI 4 connections, use public RHUI IPs as provided above)
222225
13.72.186.193
223226
13.72.14.155
224227
52.244.249.194
@@ -235,7 +238,7 @@ southeastasia - 20.24.186.80
235238

236239
### Update expired RHUI client certificate on a VM
237240

238-
If you experience RHUI certificate issues from your Azure RHEL PAYG VM, reference the [troubleshooting guidance for RHUI certificate issues in Azure](/troubleshoot/azure/virtual-machines/troubleshoot-linux-rhui-certificate-issues).
241+
If you experience RHUI certificate issues from your Azure RHEL PAYG VM, reference the [Troubleshooting guidance for RHUI certificate issues in Azure](/troubleshoot/azure/virtual-machines/troubleshoot-linux-rhui-certificate-issues).
239242

240243

241244

@@ -263,12 +266,12 @@ This procedure is provided for reference only. RHEL PAYG images already have the
263266
264267
- For RHEL 6:
265268
```bash
266-
yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel6.config' install 'rhui-azure-rhel6'
269+
sudo yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel6.config' install 'rhui-azure-rhel6'
267270
```
268271
269272
- For RHEL 7:
270273
```bash
271-
yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel7.config' install 'rhui-azure-rhel7'
274+
sudo yum --config='https://rhelimage.blob.core.windows.net/repositories/rhui-microsoft-azure-rhel7.config' install 'rhui-azure-rhel7'
272275
```
273276
274277
- For RHEL 8:
@@ -285,7 +288,7 @@ This procedure is provided for reference only. RHEL PAYG images already have the
285288
```
286289
1. Save the file and run the following command:
287290
```bash
288-
dnf --config rhel8.config install 'rhui-azure-rhel8'
291+
sudo dnf --config rhel8.config install 'rhui-azure-rhel8'
289292
```
290293
1. Update your VM
291294
```bash

0 commit comments

Comments
 (0)