Merge pull request #106848 from paulth1/three-workloads-redhat-articles

edit pass: Three workloads redhat articles

Author: ShawnJackson

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

@@ -1,6 +1,6 @@
 ---
 title: Red Hat Enterprise Linux bring-your-own-subscription Azure images | Microsoft Docs
-description: Learn about bring-your-own-subscription images for Red Hat Enterprise Linux on Azure
+description: Learn about bring-your-own-subscription images for Red Hat Enterprise Linux on Azure.
 services: virtual-machines-linux
 documentationcenter: ''
 author: asinn826
@@ -18,74 +18,74 @@ ms.author: alsin
 
 ---
 
-# Red Hat Enterprise Linux Bring-Your-Own-Subscription Gold Images in Azure
+# Red Hat Enterprise Linux bring-your-own-subscription Gold Images in Azure
 
-Red Hat Enterprise Linux (RHEL) images are available in Azure via a pay-as-you-go (PAYG) or bring-your-own-subscription (Red Hat Gold Image) model. This document provides an overview of the Red Hat Gold Images in Azure.
+Red Hat Enterprise Linux (RHEL) images are available in Azure via a pay-as-you-go or bring-your-own-subscription (BYOS) (Red Hat Gold Image) model. This article provides an overview of the Red Hat Gold Images in Azure.
 
 >[!NOTE]
-> RHEL BYOS Gold Images are available in Azure Public (commercial) and in Azure Government clouds. They are not available in Azure China or Azure Blackforest clouds.
+> RHEL BYOS Gold Images are available in Azure Public (commercial) and Azure Government clouds. They're not available in Azure China or Azure Blackforest clouds.
 
 ## Important points to consider
 
-- The Red Hat Gold Images provided in this program are production-ready RHEL images similar the RHEL PAYG images in the Azure Gallery/Marketplace.
-
-- The images follow our current policies described in [Red Hat Enterprise Linux images on Azure](./redhat-images.md)
-
-- Standard support policies apply to VMs created from these images
-
-- The VMs provisioned from Red Hat Gold Images do not carry RHEL fees associated with RHEL PAYG images
-
-- The images are unentitled, so you must use subscription-manager to register and subscribe the VMs to get updates from Red Hat directly
-
-- It is currently not possible to dynamically switch between BYOS and PAYG billing models for Linux images. Redeploying the VM from the respective image is required to switch the billing model
+- The Red Hat Gold Images provided in this program are production-ready RHEL images similar to the RHEL pay-as-you-go images in Azure Marketplace.
+- The images follow the current policies described in [Red Hat Enterprise Linux images on Azure](./redhat-images.md).
+- Standard support policies apply to VMs created from these images.
+- The VMs provisioned from Red Hat Gold Images don't carry RHEL fees associated with RHEL pay-as-you-go images.
+- The images are unentitled. You must use Red Hat Subscription-Manager to register and subscribe the VMs to get updates from Red Hat directly.
+- It's currently not possible to dynamically switch between BYOS and pay-as-you-go billing models for Linux images. To switch the billing model, you must redeploy the VM from the respective image.
 
 >[!NOTE]
-> Generation 2 RHEL BYOS images are not currently available through the marketplace offer. If you require a Gen 2 RHEL BYOS image, visit the Coud Access dashboard in Red Hat Subscription Management. More details are available at the [Red Hat documentation](https://access.redhat.com/articles/4847681).
+> Generation 2 RHEL BYOS images aren't currently available through the marketplace offer. If you require a 
+Generation 2 RHEL BYOS image, visit the Cloud Access dashboard in Red Hat subscription management. For more information, see the [Red Hat documentation](https://access.redhat.com/articles/4847681).
 
 ## Requirements and conditions to access the Red Hat Gold Images
 
-1. Get familiar with the [Red Hat Cloud Access program](https://www.redhat.com/en/technologies/cloud-computing/cloud-access) terms and enable your Red Hat subscriptions for Cloud Access at [Red Hat Subscription Manager](https://access.redhat.com/management/cloud). You will need to have on hand the Azure subscription(s) that are going to be registered for Cloud Access.
+1. Get familiar with the [Red Hat Cloud Access program](https://www.redhat.com/en/technologies/cloud-computing/cloud-access) terms. Enable your Red Hat subscriptions for Cloud Access at [Red Hat Subscription-Manager](https://access.redhat.com/management/cloud). You need to have on hand the Azure subscriptions that are going to be registered for Cloud Access.
 
-1. If you have enabled Red Hat subscriptions for Cloud Access that meet the proper eligibility requirements, your Azure subscription(s) will be automatically be enabled for Gold Image access.
+1. If the Red Hat subscriptions you enabled for Cloud Access meet the eligibility requirements, your Azure subscriptions are automatically enabled for Gold Image access.
 
 ### Expected time for image access
 
-Upon completing the Cloud Access enablement steps, Red Hat will validate your eligibility for the Red Hat Gold Images. If validation is successful, you will receive access to the Gold Images within three hours.
+After you finish the Cloud Access enablement steps, Red Hat validates your eligibility for the Red Hat Gold Images. If validation is successful, you receive access to the Gold Images within three hours.
 
 ## Use the Red Hat Gold Images from the Azure portal
 
-1. After your Azure subscription receives access to Red Hat Gold images, you can locate them in the [Azure portal](https://portal.azure.com) by navigating to **Create a Resource** and then **See all**.
+1. After your Azure subscription receives access to Red Hat Gold Images, you can locate them in the [Azure portal](https://portal.azure.com). Go to **Create a Resource** > **See all**.
 
-1. At the top of the page, you will see that you have private offers.
+1. At the top of the page, you'll see that you have private offers.
 
     ![Marketplace private offers](./media/rhel-byos-privateoffers.png)
 
-1. You can click on the purple link or scroll down to the bottom of the page to see your private offers.
+1. Select the purple link, or scroll down to the bottom of the page to see your private offers.
 
-1. The rest of provisioning in the UI will be no different to any other existing Red Hat image. Choose your RHEL version and follow the prompts to provision your VM. This process will also let you accept the terms of the image at the final step.
+1. The rest of provisioning in the UI is no different to any other existing Red Hat image. Choose your RHEL version, and follow the prompts to provision your VM. This process also lets you accept the terms of the image at the final step.
 
 >[!NOTE]
->These steps so far will not enable your Red Hat Gold Image image for programmatic deployment – an additional step will be required as described in the “Additional Information” section below.
+>These steps so far won't enable your Red Hat Gold Image for programmatic deployment. An additional step is required as described in the "Additional information" section.
 
 The rest of this document focuses on the CLI method to provision and accept terms on the image. The UI and CLI are fully interchangeable as far as the final result (a provisioned RHEL Gold Image VM) is concerned.
 
 ## Use the Red Hat Gold Images from the Azure CLI
-The following set of instructions will walk you through the initial deployment process for a RHEL VM using the Azure CLI. These instructions assume that you have the [Azure CLI installed](https://docs.microsoft.com/cli/azure/install-azure-cli).
+
+The following instructions walk you through the initial deployment process for a RHEL VM by using the Azure CLI. These instructions assume that you have the [Azure CLI installed](https://docs.microsoft.com/cli/azure/install-azure-cli).
 
 >[!IMPORTANT]
->Make sure you use all lowercase letters in the publisher, offer, plan, and image references for all the following commands
+>Make sure you use all lowercase letters in the publisher, offer, plan, and image references for all the following commands.
+
+1. Check that you're in your desired subscription.
 
-1. Check that you are in your desired subscription:
     ```azurecli
     az account show -o=json
     ```
 
-1. Create a resource group for your Red Hat Gold Image VM:
+1. Create a resource group for your Red Hat Gold Image VM.
+
     ```azurecli
     az group create --name <name> --location <location>
     ```
 
-1. Accept the image terms:
+1. Accept the image terms.
+
     ```azurecli
     az vm image terms accept --publisher redhat --offer rhel-byos --plan <SKU value here> -o=jsonc
 
@@ -96,30 +96,33 @@ The following set of instructions will walk you through the initial deployment p
 
     az vm image terms accept --urn RedHat:rhel-byos:rhel-lvm8:8.0.20190620
     ```
+
     >[!NOTE]
     >These terms need to be accepted *once per Azure subscription, per image SKU*.
 
-1. (Optional) Validate your VM deployment with the following command :
+1. (Optional) Validate your VM deployment with the following command:
+
     ```azurecli
     az vm create -n <VM name> -g <resource group name> --image <image urn> --validate
 
     # Example:
     az vm create -n rhel-byos-vm -g rhel-byos-group --image RedHat:rhel-byos:rhel-lvm75:7.5.20190620
     ```
 
-1. Provision your VM by running the same command as above without the `--validate` argument:
+1. Provision your VM by running the same command as shown in the previous example without the `--validate` argument.
+
     ```azurecli
     az vm create -n <VM name> -g <resource group name> --image <image urn> --validate
     ```
 
-1. SSH into your VM and verify that you have an unentitled image. To do this, run `sudo yum repolist` (for RHEL 8 use `sudo dnf repolist`). The output will ask you to use subscription-manager to register the VM with Red Hat.
+1. SSH into your VM, and verify that you have an unentitled image. To do this step, run `sudo yum repolist`. For RHEL 8, use `sudo dnf repolist`. The output asks you to use Subscription-Manager to register the VM with Red Hat.
 
 >[!NOTE]
->On RHEL 8 `dnf` and `yum` are interchangeable, more about this in the [RHEL 8 Admin Guide](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/configuring_basic_system_settings/installing-software-with-yum_configuring-basic-system-settings).
-
+>On RHEL 8, `dnf` and `yum` are interchangeable. For more information, see the [RHEL 8 admin guide](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/configuring_basic_system_settings/installing-software-with-yum_configuring-basic-system-settings).
 
 ## Use the Red Hat Gold Images from PowerShell
-The following is an example script. You should replace the Resource Group, location, VM name, login information, and other variables with the configuration of your choosing. Publisher and plan information must be lowercase.
+
+The following script is an example. Replace the resource group, location, VM name, login information, and other variables with the configuration of your choice. Publisher and plan information must be lowercase.
 
 ```powershell-interactive
     # Variables for common values
@@ -174,17 +177,17 @@ The following is an example script. You should replace the Resource Group, locat
     New-AzureRmVM -ResourceGroupName $resourceGroup -Location $location -VM $vmConfig
 ```
 
-## Encrypt Red Hat Enterprise Linux Bring-Your-Own-Subscription Gold Images
+## Encrypt Red Hat Enterprise Linux bring-your-own-subscription Gold Images
 
-Red Hat Enterprise Linux Bring-Your-Own-Subscription Gold Images can be secured through the use of [Azure Disk Encryption](../../linux/disk-encryption-overview.md). However, the subscription **must** be registered before enabling encryption.  Details on registering a RHEL BYOS Gold Image are available on the Red Hat site. See [How to register and subscribe a system to the Red Hat Customer Portal using Red Hat Subscription-Manager](https://access.redhat.com/solutions/253273); if you have an active Red Hat subscription, you can also read [Creating Red Hat Customer Portal Activation Keys](https://access.redhat.com/articles/1378093).
+Red Hat Enterprise Linux BYOS Gold Images can be secured through the use of [Azure Disk Encryption](../../linux/disk-encryption-overview.md). The subscription *must* be registered before you can enable encryption. For more information on how to register a RHEL BYOS Gold Image, see [How to register and subscribe a system to the Red Hat Customer Portal using Red Hat Subscription-Manager](https://access.redhat.com/solutions/253273). If you have an active Red Hat subscription, you can also read [Creating Red Hat Customer Portal Activation Keys](https://access.redhat.com/articles/1378093).
 
-Azure Disk Encryption is not supported on [Red Hat custom images](../../linux/redhat-create-upload-vhd.md). Additional ADE requirements and prerequisites are documented in [Azure Disk Encryption for Linux VMs](../../linux/disk-encryption-overview.md#additional-vm-requirements).
+Azure Disk Encryption isn't supported on [Red Hat custom images](../../linux/redhat-create-upload-vhd.md). Additional Azure Disk Encryption requirements and prerequisites are documented in [Azure Disk Encryption for Linux VMs](../../linux/disk-encryption-overview.md#additional-vm-requirements).
 
-Steps for applying Azure Disk Encryption are available in [Azure Disk Encryption scenarios on Linux VMs](../../linux/disk-encryption-linux.md) and related articles.
+For steps to apply Azure Disk Encryption, see [Azure Disk Encryption scenarios on Linux VMs](../../linux/disk-encryption-linux.md) and related articles.
 
 ## Additional information
 
-- If you attempt to provision a VM on a subscription that is not enabled for this offer, you will get the following error:
+- If you attempt to provision a VM on a subscription that isn't enabled for this offer, you get the following message:
 
     ```
     "Offer with PublisherId: redhat, OfferId: rhel-byos, PlanId: rhel-lvm75 is private and can not be purchased by subscriptionId: GUID"
@@ -200,15 +203,17 @@ Steps for applying Azure Disk Encryption are available in [Azure Disk Encryption
     -g AnotherGroupName --location EastUS2 -n VMName \
     --plan-publisher redhat --plan-product rhel-byos --plan-name rhel-lvm75
     ```
-    Note the plan parameters in the final line above.
 
-    [Azure Disk Encryption](#encrypt-red-hat-enterprise-linux-bring-your-own-subscription-gold-images) is not supported on custom images.
+    Note the plan parameters in the final line.
 
-- If you are using automation to provision VMs from the RHEL BYOS images, you must provide plan parameters similar to what was shown above. For example, if you are using Terraform, you would provide the plan information in a [plan block](https://www.terraform.io/docs/providers/azurerm/r/virtual_machine.html#plan).
+    [Azure Disk Encryption](#encrypt-red-hat-enterprise-linux-bring-your-own-subscription-gold-images) isn't supported on custom images.
+
+- If you use automation to provision VMs from the RHEL BYOS images, you must provide plan parameters similar to what was shown in the sample commands. For example, if you use Terraform, you provide the plan information in a [plan block](https://www.terraform.io/docs/providers/azurerm/r/virtual_machine.html#plan).
 
 ## Next steps
-- Step-by-step guides and program details for Cloud Access are available in the [Red Hat Cloud Access documentation.](https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/red_hat_cloud_access_reference_guide/index)
-- Learn more about the [Azure Red Hat Update Infrastructure](./redhat-rhui.md).
-- To learn more about all the Red Hat images in Azure, go to the [documentation page](./redhat-images.md).
-- Information on Red Hat support policies for all versions of RHEL can be found on the [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata) page.
-- Additional documentation on the RHEL Gold Images can be found at the [Red Hat documentation](https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/red_hat_cloud_access_reference_guide/using_red_hat_gold_images#con-gold-image-azure).
+
+- For step-by-step guides and program details for Cloud Access, see the [Red Hat Cloud Access documentation](https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/red_hat_cloud_access_reference_guide/index).
+- To learn more about the Red Hat Update Infrastructure, see [Azure Red Hat Update Infrastructure](./redhat-rhui.md).
+- To learn more about all the Red Hat images in Azure, see the [documentation page](./redhat-images.md).
+- For information on Red Hat support policies for all versions of RHEL, see the [Red Hat Enterprise Linux life cycle](https://access.redhat.com/support/policy/updates/errata) page.
+- For additional documentation on the RHEL Gold Images, see the [Red Hat documentation](https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/red_hat_cloud_access_reference_guide/using_red_hat_gold_images#con-gold-image-azure).