Skip to content

Commit c961f9b

Browse files
Update oracle-create-upload-vhd.md
1 parent 03116e4 commit c961f9b

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

articles/virtual-machines/linux/oracle-create-upload-vhd.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -19,21 +19,21 @@ ms.reviewer: mattmcinnes
1919
This article assumes that you have already installed an Oracle Linux operating system to a virtual hard disk. Multiple tools exist to create .vhd files, for example a virtualization solution such as Hyper-V. For instructions, see [Install the Hyper-V Role and Configure a Virtual Machine](/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/hh846766(v=ws.11)).
2020

2121
## Oracle Linux installation notes
22-
* Please see also [General Linux Installation Notes](create-upload-generic.md#general-linux-installation-notes) for more tips on preparing Linux for Azure.
22+
* See also [General Linux Installation Notes](create-upload-generic.md#general-linux-installation-notes) for more tips on preparing Linux for Azure.
2323
* Hyper-V and Azure support Oracle Linux with either the Unbreakable Enterprise Kernel (UEK) or the Red Hat Compatible Kernel.
2424
* Oracle's UEK2 is not supported on Hyper-V and Azure as it does not include the required drivers.
2525
* The VHDX format is not supported in Azure, only **fixed VHD**. You can convert the disk to VHD format using Hyper-V Manager or the convert-vhd cmdlet.
26-
* **Kernel support for mounting UDF file systems is required.** At first boot on Azure the provisioning configuration is passed to the Linux VM via UDF-formatted media that is attached to the guest. The Azure Linux agent must be able to mount the UDF file system to read its configuration and provision the VM.
27-
* When installing the Linux system it is recommended that you use standard partitions rather than LVM (often the default for many installations). This will avoid LVM name conflicts with cloned VMs, particularly if an OS disk ever needs to be attached to another VM for troubleshooting. [LVM](/previous-versions/azure/virtual-machines/linux/configure-lvm) or [RAID](/previous-versions/azure/virtual-machines/linux/configure-raid) may be used on data disks if preferred.
26+
* **Kernel support for mounting UDF file systems is required.** At first boot on Azure, the provisioning configuration is passed to the Linux VM via UDF-formatted media that is attached to the guest. The Azure Linux agent must be able to mount the UDF file system to read its configuration and provision the VM.
27+
* When installing the Linux system, it is recommended that you use standard partitions rather than LVM (often the default for many installations). This standard partitions will avoid LVM name conflicts with cloned VMs, particularly if an OS disk ever needs to be attached to another VM for troubleshooting. [LVM](/previous-versions/azure/virtual-machines/linux/configure-lvm) or [RAID](/previous-versions/azure/virtual-machines/linux/configure-raid) may be used on data disks if preferred.
2828
* Linux kernel versions earlier than 2.6.37 don't support NUMA on Hyper-V with larger VM sizes. This issue primarily impacts older distributions using the upstream Red Hat 2.6.32 kernel, and was fixed in Oracle Linux 6.6 and later
29-
* Do not configure a swap partition on the OS disk. More information about this can be found in the steps below.
30-
* All VHDs on Azure must have a virtual size aligned to 1MB. When converting from a raw disk to VHD you must ensure that the raw disk size is a multiple of 1MB before conversion. See [Linux Installation Notes](create-upload-generic.md#general-linux-installation-notes) for more information.
29+
* Do not configure a swap partition on the OS disk. More information will be found below.
30+
* All VHDs on Azure must have a virtual size aligned to 1MB. When converting from a raw disk to VHD, you must ensure that the raw disk size is a multiple of 1MB before conversion. See [Linux Installation Notes](create-upload-generic.md#general-linux-installation-notes) for more information.
3131
* Make sure that the `Addons` repository is enabled. Edit the file `/etc/yum.repos.d/public-yum-ol6.repo`(Oracle Linux 6) or `/etc/yum.repos.d/public-yum-ol7.repo`(Oracle Linux 7), and change the line `enabled=0` to `enabled=1` under **[ol6_addons]** or **[ol7_addons]** in this file.
3232

3333
## Oracle Linux 6.X
3434

3535
> [!IMPORTANT]
36-
> Please note that Oracle Linux has reached its end of life and is [no longer supported by Oracle](https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf). This means that no new updates or patches will be provided, and technical support may not be available. It is recommended that users migrate to a newer and supported version of Linux to ensure security and stability. We cannot be held responsible for any issues that may arise from continuing to use Oracle Linux after its end of life.
36+
> Keep in consideration Oracle Linux 6.x is already EOL. Oracle Linux version 6.10 has available [ELS support](https://www.oracle.com/a/ocom/docs/linux/oracle-linux-extended-support-ds.pdf), which [will end on 07/2024](https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf).
3737
3838
You must complete specific configuration steps in the operating system for the virtual machine to run in Azure.
3939

@@ -45,7 +45,9 @@ You must complete specific configuration steps in the operating system for the v
4545
sudo rpm -e --nodeps NetworkManager
4646
```
4747

48-
**Note:** If the package is not already installed, this command will fail with an error message. This is expected.
48+
> [!NOTE]
49+
> If the package is not already installed, this command fails with an error message. This messages is expected.
50+
4951
4. Create a file named **network** in the `/etc/sysconfig/` directory that contains the following text:
5052

5153
```config
@@ -72,7 +74,7 @@ You must complete specific configuration steps in the operating system for the v
7274
sudo rm -f /etc/udev/rules.d/70-persistent-net.rules
7375
```
7476

75-
7. Ensure the network service will start at boot time by running the following command:
77+
7. Ensure the network service starts at boot time by running the following command:
7678

7779
```bash
7880
sudo chkconfig network on
@@ -90,7 +92,7 @@ You must complete specific configuration steps in the operating system for the v
9092
console=ttyS0 earlyprintk=ttyS0
9193
```
9294

93-
This will ensure all console messages are sent to the first serial port, which can assist Azure support with debugging issues.
95+
This ensures all console messages are sent to the first serial port, which can assist Azure support with debugging issues.
9496

9597
In addition to the above, it is recommended to *remove* the following parameters:
9698

@@ -109,11 +111,11 @@ You must complete specific configuration steps in the operating system for the v
109111
sudo yum install WALinuxAgent
110112
```
111113

112-
Note that installing the WALinuxAgent package will remove the NetworkManager and NetworkManager-gnome packages if they were not already removed as described in step 2.
114+
Installing the WALinuxAgent package removes the NetworkManager and NetworkManager-gnome packages if they were not already removed as described in step 2.
113115

114116
12. Do not create swap space on the OS disk.
115117

116-
The Azure Linux Agent can automatically configure swap space using the local resource disk that is attached to the VM after provisioning on Azure. Note that the local resource disk is a *temporary* disk, and might be emptied when the VM is deprovisioned. After installing the Azure Linux Agent (see previous step), modify the following parameters in /etc/waagent.conf appropriately:
118+
The Azure Linux Agent can automatically configure swap space using the local resource disk that is attached to the VM after provisioning on Azure. The local resource disk is a *temporary* disk, and might be emptied when the VM is deprovisioned. After installing the Azure Linux Agent (see previous step), modify the following parameters in /etc/waagent.conf appropriately:
117119

118120
```config-conf
119121
ResourceDisk.Format=y
@@ -137,7 +139,7 @@ You must complete specific configuration steps in the operating system for the v
137139
## Oracle Linux 7.0 and later
138140
**Changes in Oracle Linux 7**
139141

140-
Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle Linux 6, however there are several important differences worth noting:
142+
Preparing an Oracle Linux 7 virtual machine for Azure is similar to Oracle Linux 6, however there are several important differences worth noting:
141143

142144
* Azure supports Oracle Linux with either the Unbreakable Enterprise Kernel (UEK) or the Red Hat Compatible Kernel. Oracle Linux with UEK is recommended.
143145
* The NetworkManager package no longer conflicts with the Azure Linux agent. This package is installed by default and we recommend that it is not removed.
@@ -173,7 +175,7 @@ Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle
173175
sudo ln -s /dev/null /etc/udev/rules.d/75-persistent-net-generator.rules
174176
```
175177

176-
6. Ensure the network service will start at boot time by running the following command:
178+
6. Ensure the network service starts at boot time by running the following command:
177179

178180
```bash
179181
sudo chkconfig network on
@@ -192,7 +194,7 @@ Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle
192194
sudo yum -y update
193195
```
194196

195-
9. Modify the kernel boot line in your grub configuration to include additional kernel parameters for Azure. To do this open "/etc/default/grub" in a text editor and edit the `GRUB_CMDLINE_LINUX` parameter, for example:
197+
9. Modify the kernel boot line in your grub configuration to include more kernel parameters for Azure. To do this open "/etc/default/grub" in a text editor and edit the `GRUB_CMDLINE_LINUX` parameter, for example:
196198

197199
```config-grub
198200
GRUB_CMDLINE_LINUX="console=ttyS0 earlyprintk=ttyS0 net.ifnames=0"

0 commit comments

Comments
 (0)