Learn Editor: Update oracle-create-upload-vhd.md

Author: msaenzbosupport

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

@@ -11,6 +11,7 @@ ms.date: 11/09/2021
 ms.author: srijangupta
 ms.reviewer: mattmcinnes
 ---
+
 # Prepare an Oracle Linux virtual machine for Azure
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Flexible scale sets 
@@ -29,15 +30,19 @@ This article assumes that you have already installed an Oracle Linux operating s
 * 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.
 * 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.
 
-## Oracle Linux 6.4 and later
+## Oracle Linux 6.X 
+
+> [!IMPORTANT]
+> 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.
+
 You must complete specific configuration steps in the operating system for the virtual machine to run in Azure.
 
 1. In the center pane of Hyper-V Manager, select the virtual machine.
 2. Click **Connect** to open the window for the virtual machine.
 3. Uninstall NetworkManager by running the following command:
 
-    ```console
-    # sudo rpm -e --nodeps NetworkManager
+    ```bash
+    sudo rpm -e --nodeps NetworkManager
     ```
 
     **Note:** If the package is not already installed, this command will fail with an error message. This is expected.
@@ -62,21 +67,21 @@ You must complete specific configuration steps in the operating system for the v
 
 6. Modify udev rules to avoid generating static rules for the Ethernet interface(s). These rules can cause problems when cloning a virtual machine in Microsoft Azure or Hyper-V:
 
-    ```console
-    # sudo ln -s /dev/null /etc/udev/rules.d/75-persistent-net-generator.rules
-    # sudo rm -f /etc/udev/rules.d/70-persistent-net.rules
+    ```bash
+    sudo ln -s /dev/null /etc/udev/rules.d/75-persistent-net-generator.rules
+    sudo rm -f /etc/udev/rules.d/70-persistent-net.rules
     ```
 
 7. Ensure the network service will start at boot time by running the following command:
 
-    ```console
-    # chkconfig network on
+    ```bash
+    sudo chkconfig network on
     ```
 
 8. Install python-pyasn1 by running the following command:
 
-    ```console
-    # sudo yum install python-pyasn1
+    ```bash
+    sudo yum install python-pyasn1
     ```
 
 9. Modify the kernel boot line in your grub configuration to include additional kernel parameters for Azure. To do this open "/boot/grub/menu.lst" in a text editor and ensure that the kernel includes the following parameters:
@@ -96,14 +101,18 @@ You must complete specific configuration steps in the operating system for the v
    Graphical and quiet boot are not useful in a cloud environment where we want all the logs to be sent to the serial port.
 
    The `crashkernel` option may be left configured if desired, but note that this parameter will reduce the amount of available memory in the VM by 128MB or more, which may be problematic on the smaller VM sizes.
+
 10. Ensure that the SSH server is installed and configured to start at boot time.  This is usually the default.
-11. Install the Azure Linux Agent by running the following command. The latest version is 2.0.15.
+1. 11. Install the Azure Linux Agent by running the following command. The latest version is 2.0.15.
 
-    ```console
-    # sudo yum install WALinuxAgent
+
+        
+    
+```bash
+         sudo yum install WALinuxAgent
     ```
 
-    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.
+        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.
 12. Do not create swap space on the OS disk.
 
     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,10 +127,10 @@ You must complete specific configuration steps in the operating system for the v
 
 13. Run the following commands to deprovision the virtual machine and prepare it for provisioning on Azure:
 
-    ```console
-    # sudo waagent -force -deprovision
-    # export HISTSIZE=0
-    # logout
+    ```bash
+    sudo waagent -force -deprovision
+    sudo export HISTSIZE=0
+    sudo logout
     ```
 
 14. Click **Action -> Shut Down** in Hyper-V Manager. Your Linux VHD is now ready to be [**uploaded to Azure**](./upload-vhd.md#option-1-upload-a-vhd).
@@ -162,27 +171,27 @@ Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle
 
 5. Modify udev rules to avoid generating static rules for the Ethernet interface(s). These rules can cause problems when cloning a virtual machine in Microsoft Azure or Hyper-V:
 
-    ```console
-    # sudo ln -s /dev/null /etc/udev/rules.d/75-persistent-net-generator.rules
+    ```bash
+    sudo ln -s /dev/null /etc/udev/rules.d/75-persistent-net-generator.rules
     ```
 
 6. Ensure the network service will start at boot time by running the following command:
 
-    ```console
-    # sudo chkconfig network on
+    ```bash
+    sudo chkconfig network on
     ```
 
 7. Install the python-pyasn1 package by running the following command:
 
-    ```console
-    # sudo yum install python-pyasn1
+    ```bash
+    sudo yum install python-pyasn1
     ```
 
 8. Run the following command to clear the current yum metadata and install any updates:
 
-    ```console 
-    # sudo yum clean all
-    # sudo yum -y update
+    ```bash 
+    sudo yum clean all
+    sudo yum -y update
     ```
 
 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:
@@ -200,10 +209,10 @@ Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle
    Graphical and quiet boot are not useful in a cloud environment where we want all the logs to be sent to the serial port.
 
    The `crashkernel` option may be left configured if desired, but note that this parameter will reduce the amount of available memory in the VM by 128MB or more, which may be problematic on the smaller VM sizes.
-10. Once you are done editing "/etc/default/grub" per above, run the following command to rebuild the grub configuration:
 
-    ```console
-    # sudo grub2-mkconfig -o /boot/grub2/grub.cfg
+10. Once you are done editing "/etc/default/grub" per above, run the following command to rebuild the grub configuration:
+1. ```bash
+       sudo grub2-mkconfig -o /boot/grub2/grub.cfg
     ```
 
 11. Ensure that the SSH server is installed and configured to start at boot time.  This is usually the default.
@@ -216,28 +225,38 @@ Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle
 
 13. Install cloud-init to handle the provisioning
 
-    ```console
-    yum install -y cloud-init cloud-utils-growpart gdisk hyperv-daemons
+    ```bash
+    sudo yum install -y cloud-init cloud-utils-growpart gdisk hyperv-daemons
+    ```
 
-    # Configure waagent for cloud-init
-    sed -i 's/Provisioning.UseCloudInit=n/Provisioning.UseCloudInit=y/g' /etc/waagent.conf
-    sed -i 's/Provisioning.Enabled=y/Provisioning.Enabled=n/g' /etc/waagent.conf
+14. Configure waagent for cloud-init
 
+    ```bash
+    sudo sed -i 's/Provisioning.UseCloudInit=n/Provisioning.UseCloudInit=y/g' /etc/waagent.conf
+    sudo sed -i 's/Provisioning.Enabled=y/Provisioning.Enabled=n/g' /etc/waagent.conf
+    ```
 
-    echo "Adding mounts and disk_setup to init stage"
-    sed -i '/ - mounts/d' /etc/cloud/cloud.cfg
-    sed -i '/ - disk_setup/d' /etc/cloud/cloud.cfg
-    sed -i '/cloud_init_modules/a\\ - mounts' /etc/cloud/cloud.cfg
-    sed -i '/cloud_init_modules/a\\ - disk_setup' /etc/cloud/cloud.cfg
+    ```bash
+    sudo echo "Adding mounts and disk_setup to init stage"
+    sudo sed -i '/ - mounts/d' /etc/cloud/cloud.cfg
+    sudo sed -i '/ - disk_setup/d' /etc/cloud/cloud.cfg
+    sudo sed -i '/cloud_init_modules/a\\ - mounts' /etc/cloud/cloud.cfg
+    sudo sed -i '/cloud_init_modules/a\\ - disk_setup' /etc/cloud/cloud.cfg
+    ```  
 
+    ```bash
     echo "Allow only Azure datasource, disable fetching network setting via IMDS"
-    cat > /etc/cloud/cloud.cfg.d/91-azure_datasource.cfg <<EOF
+    ```
+
+    ```bash
+    sudo cat > /etc/cloud/cloud.cfg.d/91-azure_datasource.cfg <<EOF
     datasource_list: [ Azure ]
     datasource:
         Azure:
             apply_network_config: False
     EOF
 
+
     if [[ -f /mnt/resource/swapfile ]]; then
     echo Removing swapfile - RHEL uses a swapfile by default
     swapoff /mnt/resource/swapfile
@@ -252,61 +271,53 @@ Preparing an Oracle Linux 7 virtual machine for Azure is very similar to Oracle
     # there without needing to look on the console.
     output: {all: '| tee -a /var/log/cloud-init-output.log'}
     EOF
-
     ```
 
-14. Swap configuration 
-    Do not create swap space on the operating system disk.
+15. Swap configuration. Do not create swap space on the operating system disk.
 
-    Previously, the Azure Linux Agent was used automatically configure swap space by using the local resource disk that is attached to the virtual machine after the virtual machine is provisioned on Azure. However this is now handled by cloud-init, you **must not** use the Linux Agent to format the resource disk create the swap file, modify the following parameters in `/etc/waagent.conf` appropriately:
+     Previously, the Azure Linux Agent was used automatically configure swap space by using the local resource disk that is attached to the virtual machine after the virtual   machine is provisioned on Azure. However this is now handled by cloud-init, you **must not** use the Linux Agent to format the resource disk create the swap file, modify the  following parameters in `/etc/waagent.conf` appropriately:
 
-    ```console
-    sed -i 's/ResourceDisk.Format=y/ResourceDisk.Format=n/g' /etc/waagent.conf
-    sed -i 's/ResourceDisk.EnableSwap=y/ResourceDisk.EnableSwap=n/g' /etc/waagent.conf
+    ```bash
+    sudo sed -i 's/ResourceDisk.Format=y/ResourceDisk.Format=n/g' /etc/waagent.conf
+    sudo sed -i 's/ResourceDisk.EnableSwap=y/ResourceDisk.EnableSwap=n/g' /etc/waagent.conf
     ```
 
-    If you want mount, format and create swap you can either:
-    * Pass this in as a cloud-init config every time you create a VM
-    * Use a cloud-init directive baked into the image that will do this every time the VM is created:
-
-        ```console
-        echo 'DefaultEnvironment="CLOUD_CFG=/etc/cloud/cloud.cfg.d/00-azure-swap.cfg"' >> /etc/systemd/system.conf
-        cat > /etc/cloud/cloud.cfg.d/00-azure-swap.cfg << EOF
-        #cloud-config
-        # Generated by Azure cloud image build
-        disk_setup:
-          ephemeral0:
-            table_type: mbr
-            layout: [66, [33, 82]]
-            overwrite: True
-        fs_setup:
-          - device: ephemeral0.1
-            filesystem: ext4
-          - device: ephemeral0.2
-            filesystem: swap
-        mounts:
-          - ["ephemeral0.1", "/mnt"]
-          - ["ephemeral0.2", "none", "swap", "sw,nofail,x-systemd.requires=cloud-init.service,x-systemd.device-timeout=2", "0", "0"]
-        EOF
-        ```
+     If you want mount, format and create swap you can either:
+     * Pass this in as a cloud-init config every time you create a VM
+     * Use a cloud-init directive baked into the image that will do this every time the VM is created:
 
+    ```console
+    echo 'DefaultEnvironment="CLOUD_CFG=/etc/cloud/cloud.cfg.d/00-azure-swap.cfg"' >> /etc/systemd/system.conf
+    cat > /etc/cloud/cloud.cfg.d/00-azure-swap.cfg << EOF
+    #cloud-config
+    # Generated by Azure cloud image build
+    disk_setup:
+      ephemeral0:
+        table_type: mbr
+        layout: [66, [33, 82]]
+        overwrite: True
+    fs_setup:
+      - device: ephemeral0.1
+        filesystem: ext4
+      - device: ephemeral0.2
+        filesystem: swap
+    mounts:
+      - ["ephemeral0.1", "/mnt"]
+      - ["ephemeral0.2", "none", "swap", "sw,nofail,x-systemd.requires=cloud-init.service,x-systemd.device-timeout=2", "0", "0"]
+    EOF
+    ```
 
 15. Run the following commands to deprovision the virtual machine and prepare it for provisioning on Azure:
 
-    **Note:** if you are migrating a specific virtual machine and do not wish to create a generalized image,skip the deprovision step
-    
-	```console
-    # sudo cloud-init clean
-    # sudo rm -f /var/log/waagent.log
-
-    # waagent -force -deprovision+user
-    # rm -f ~/.bash_history
-    
-
-    # export HISTSIZE=0
+1. **Note:** if you are migrating a specific virtual machine and do not wish to create a generalized image, skip the deprovision step.
 
-    # logout
-	```
+1. ```bash
+        sudo cloud-init clean
+        sudo rm -f /var/log/waagent.log
+        sudo waagent -force -deprovision
+        sudo rm -f ~/.bash_history
+        sudo export HISTSIZE=0
+    ```
 
 16. Click **Action -> Shut Down** in Hyper-V Manager. Your Linux VHD is now ready to be [**uploaded to Azure**](./upload-vhd.md#option-1-upload-a-vhd).