Merge pull request #289189 from ktoliver/323659

[AQ] edit pass: Oracle Database@Azure articles (work item 323659)

Author: ShawnJackson

articles/oracle/oracle-db/faq-oracle-database-azure.md

@@ -1,6 +1,6 @@
 ---
 title: Link Oracle Database@Azure to multiple Azure subscriptions
-description: Learn about how to link Oracle Database@Azure to multiple Azure subscriptions.
+description: Learn how to link your Oracle Database@Azure resources to multiple Azure subscriptions.
 author: jjaygbay1
 ms.author: jacobjaygbay
 ms.topic: how-to
@@ -10,32 +10,49 @@ ms.custom: engagement-fy24
 ---
 
 # Link Oracle Database@Azure to multiple Azure subscriptions
-Learn about how to link Oracle Database@Azure to multiple Azure subscriptions.
 
-You can use Oracle Database@Azure within two or more [Azure subscriptions](/azure/cloud-adoption-framework/ready/azure-setup-guide/organize-resources) within a single Azure account. This feature gives you the ability to isolate projects, environments, and application domains for security and cost allocation, while maintaining a single Azure account for simplified billing and account management. When using two or more Azure subscriptions with Oracle Database@Azure, all Azure subscriptions are linked to the OCI tenancy used for service onboarding.
+In this article, learn how to link your Oracle Database@Azure resources to multiple Azure subscriptions.
+
+You can use Oracle Database@Azure resources in multiple [Azure subscriptions](/azure/cloud-adoption-framework/ready/azure-setup-guide/organize-resources) within a single Azure account. You can isolate projects, environments, and application domains for security and cost allocation while maintaining a single Azure account for simplified billing and account management. When you use two or more Azure subscriptions with Oracle Database@Azure, all Azure subscriptions are linked to the Oracle Cloud Infrastructure (OCI) tenancy that you use to onboard the service instance.
 
 ## Prerequisites
-- You must onboard with Oracle Database@Azure before you can link Azure subscriptions to the service as described in this article. For more information, see [Onboarding with Oracle Database@Azure](onboard-oracle-database.md).
-- Add the ``Oracle.Database`` resource provider to the subscription you're adding to the service. To add the subscription, navigate to the Azure subscription details page, then select Resource providers under Settings. Select ``Oracle.Database`` in the list of providers, then select **Register**.
-- Add the ``Microsoft.BareMetal``, ``Microsoft.Network``, and ``Microsoft.Compute`` resources providers to the subscription you're adding to the service. Add these resources from the Azure subscription details page, as you added the ``Oracle.Database`` resource provider described in the preceding prerequisite. 
->[!Note]
->You can't provision Oracle Database@Azure resources until these Azure resource providers are registered for the subscription you're adding.
 
-## How multiple Azure subscriptions work in Oracle Database@Azure
-During Oracle Database@Azure onboarding, you select an Azure subscription to use initially with the service. In this documentation, the subscription selected during onboarding is referred to as the primary subscription for Oracle Database@Azure. After onboarding is complete and your Azure account is linked to your OCI tenancy, the OCI tenancy has a new, automatically created [compartment](https://docs.oracle.com/en-us/iaas/Content/Identity/compartments/managingcompartments.htm) for the management of the service.
+- Oracle Database@Azure is onboarded before you link Azure subscriptions to the service instance.
+
+  For more information, see [Onboard Oracle Database@Azure](onboard-oracle-database.md).
+
+- The following resource providers are added to the subscription that you add to the service instance:
+
+  - Oracle.Database
+  - Microsoft.BareMetal
+  - Microsoft.Network
+  - Microsoft.Compute
+
+  You can't provision Oracle Database@Azure resources until these Azure resource providers are registered for the subscription you add.
+
+  To add a resource provider to a subscription:
+  
+  1. In the Azure portal, go to the Azure subscription that you want to add.
+  1. In the service menu under **Settings**, select **Resource providers**.
+  1. In the list of providers, select the resource provider, and then select **Register**.
+
+## Use multiple Azure subscriptions with Oracle Database@Azure
+
+When you onboard Oracle Database@Azure, you select an Azure subscription to initially use with the service instance. In Azure documentation, the subscription you select when you onboard Oracle Database@Azure is called the *primary subscription*.
 
-When you add more Azure subscriptions to your Oracle Database@Azure service, the service automatically creates a child compartment within the main Oracle Database@Azure compartment created during onboarding. You don't have to do any manual configuration of your OCI tenancy to add more Azure subscriptions to the service.
+When onboarding is complete and your Azure account is linked to your OCI tenancy, a new [compartment](https://docs.oracle.com/iaas/Content/Identity/compartments/managingcompartments.htm) is automatically created for the service instance. When you add an Azure subscription to your Oracle Database@Azure service instance, the service automatically creates a child compartment in the main Oracle Database@Azure compartment that was created in the onboarding process. No manual configuration of your OCI tenancy is required to add more Azure subscriptions.
 
->[!Important]
-> When adding Azure subscriptions to your Oracle Database@Azure service, the new subscriptions must use the same billing account as the primary Azure subscription selected during service onboarding.
+> [!IMPORTANT]
+> When you add another Azure subscription to your Oracle Database@Azure service instance, the new subscription must use the same billing account as the Azure primary subscription.
 
-After you add a new Azure subscription to the Oracle Database@Azure service, you can begin provisioning database resources in that subscription. For database systems with more than one component (for example, Exadata systems with an infrastructure resource and a VM cluster resource), all components must be provisioned within the same subscription. When users are working within an Azure subscription, they only see the Oracle Database@Azure resources provisioned within that subscription. Database resources provisioned in other subscriptions aren't visible to the user.
+After you add a new Azure subscription to the Oracle Database@Azure service instance, you can begin provisioning database resources in that subscription. For database systems that have more than one component (for example, an Oracle Exadata system with an infrastructure resource and a virtual machine cluster resource), all components must be provisioned in the same subscription. When a user works in an Azure subscription, they can view only the Oracle Database@Azure resources that are provisioned in that subscription. Database resources that are provisioned in other subscriptions aren't visible to the user.
 
-## Add an Azure subscription to the Oracle Database@Azure service
+## Add an Azure subscription to your Oracle Database@Azure instance
 
-1. Sign in to the Azure portal and navigate to the details page of your primary Oracle Database@Azure subscription (this is the subscription selected during onboarding). For more information, see [Filter and view subscriptions](/azure/cost-management-billing/manage/filter-view-subscriptions) in the Azure documentation for details. If you don't know the name of the subscription, ask your Azure account administrator.
-2. On the details page for your Oracle subscription, select **Add subscriptions**.
-3. In the **Add Azure Subscriptions** panel, select one or more subscriptions to add to your service using the **Azure Subscriptions** selector, then select **Add**.
-4. On the details page of the primary Oracle Database@Azure, you can see the number of active subscriptions for the service under **Account management**. When the subscriptions you added are ready for use, you see a **Validated** message in the **Account management** section.
+1. In the Azure portal, go to the details pane of your primary subscription for Oracle Database@Azure (the subscription you selected during onboarding).
 
+   For more information, see [Filter and view subscriptions](/azure/cost-management-billing/manage/filter-view-subscriptions). If you don't know the name of the subscription, contact your Azure account administrator.
 
+1. Select **Add subscriptions**.
+1. On the **Add Azure subscriptions** pane, select one or more Azure subscriptions to add to your service instance, and then select **Add**.
+1. On the details pane for the Oracle Database@Azure primary subscription, under **Account management**, the number of active subscriptions for the service instance appears. When the subscription that you added is ready to use with the Oracle Database@Azure instance resources, a status of **Validated** for the subscription is shown.

articles/oracle/oracle-db/link-oracle-database-multiple-subscription.md

@@ -1,6 +1,6 @@
 ---
-title: Onboard with Oracle Database@Azure
-description: Learn about onboarding with OracleOracle Database@Azure.
+title: "Onboard Oracle Database@Azure"
+description: Learn about purchase and configuration steps to onboard Oracle Database@Azure.
 author: jjaygbay1
 ms.service: oracle-on-azure
 ms.collection: linux
@@ -10,27 +10,27 @@ ms.custom: engagement-fy23
 ms.author: jacobjaygbay
 ---
 
-# Onboard with Oracle Database@Azure 
+# Onboard Oracle Database@Azure
 
-In this article, you learn about the purchase and configuration of Oracle Database@Azure, which is called onboarding.
+In this article, learn about purchase and configuration (*onboarding*) steps for Oracle Database@Azure.
 
-You perform most onboarding tasks only one time, during your Oracle Database@Azure deployment. After you complete the onboarding tasks, you can begin provisioning and using Oracle Database resources in your Azure environment.
+You complete most onboarding tasks only once, when you create your Oracle Database@Azure deployment. After you complete the onboarding tasks, you can begin provisioning and using Oracle database resources in your Azure environment.
 
-## Purchase Oracle Database@Azure
+## Purchase options for Oracle Database@Azure
 
-The exact set of tasks you perform depends on the type of offer you purchase (Pay as You Go or private offer) and the database products you plan to use (Oracle Autonomous Database and Oracle Exadata Database Service). For details on the differences between the Pay as You Go offer and the private offer, see [Purchase Oracle Database@Azure](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/getting-started.htm#oaa_purchasing).
+The set of onboarding tasks you complete depends on the type of offer you purchase (pay-as-you-go or a private offer) and the database products you plan to use (Oracle Autonomous Database or Oracle Exadata). For more information about the differences between a pay-as-you-go offer and a private offer, see [Purchase Oracle Database@Azure](https://docs.oracle.com/iaas/Content/database-at-azure/getting-started.htm#oaa_purchasing).
 
-Most of the onboarding tasks apply to all deployments. For tasks (or task sections) that depend on offer type or Oracle Database product, the documentation explains which tasks need to be completed for which scenarios.
+Most Oracle Database@Azure onboarding tasks apply to all deployments. If a task is based on an offer type or on the Oracle database product you choose, specific requirements for that scenario are identified in the Azure documentation.
 
-Onboarding uses both the Azure portal and the OCI Console.
+When you set up an instance of Oracle Database@Azure, you use both the Azure portal and the Oracle Cloud Infrastructure (OCI) console.
 
-## Steps to onboard with Oracle Database@Azure
+## Steps to onboard Oracle Database@Azure
 
-1. [Prerequisites](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/getting-started.htm#oaa_prerequisites)
-1. [Accept Private Offer](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-2.htm#oaaonboard_task_2) (private offer purchases only)
-1. [Purchase Offer](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-3.htm#oaaonboard_task_3)
-1. [Link an OCI Account](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-4.htm#oaaonboard_task_4)
-1. [Register with My Oracle Support](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-5.htm)
-1. [Find the Azure Availability Zone Mapping](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-6.htm#oaaonboard_task_6) (optional)
-1. [Set Up Role Based Access Control](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-7.htm#oaaonboard_task_7)
-1. [Set Up Identity Federation](https://docs.oracle.com/en-us/iaas/Content/database-at-azure/oaaonboard-task-8.htm#oaaonboard_task_8) (optional)
+1. [Prerequisites](https://docs.oracle.com/iaas/Content/database-at-azure/getting-started.htm#oaa_prerequisites)
+1. [Accept a private offer](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-2.htm#oaaonboard_task_2) (private offer purchases only)
+1. [Purchase an offer](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-3.htm#oaaonboard_task_3)
+1. [Link an OCI account](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-4.htm#oaaonboard_task_4)
+1. [Register with My Oracle Support](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-5.htm)
+1. [Find Azure availability zone mapping](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-6.htm#oaaonboard_task_6) (optional)
+1. [Set up role-based access control](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-7.htm#oaaonboard_task_7)
+1. [Set up an identity federation](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard-task-8.htm#oaaonboard_task_8) (optional)