feedback added

jjaygbay · jjaygbay · commit 596d82d41dcb · 2024-09-24T12:36:45.000-04:00
diff --git a/articles/oracle/oracle-db/faq-oracle-database-azure.md b/articles/oracle/oracle-db/faq-oracle-database-azure.md
@@ -134,7 +134,7 @@ None. The OCI connection is primarily utilized for OCI control plane to manage t
 
 ### How do I achieve low latencies between my application and Database tiers?
 
-You can deploy your application and database in the same virtual network or a peered VNETs in the same region and availability zone for lowest possible latencies.
+You can deploy your application and database in the same virtual network or a peered virtual networks in the same region and availability zone for lowest possible latencies.
 
 ## Management
 In this section, we cover questions related to management for Oracle Database@Azure.
diff --git a/articles/oracle/oracle-db/media/deny-known-issue-purchase-failure.png b/articles/oracle/oracle-db/media/deny-known-issue-purchase-failure.png
diff --git a/articles/oracle/oracle-db/media/example-known-issue-purchase-failure.png b/articles/oracle/oracle-db/media/example-known-issue-purchase-failure.png
diff --git a/articles/oracle/oracle-db/media/exemption-known-issue-purchase-failure.png b/articles/oracle/oracle-db/media/exemption-known-issue-purchase-failure.png
diff --git a/articles/oracle/oracle-db/media/workflow-known-issue-purchase-failure.png b/articles/oracle/oracle-db/media/workflow-known-issue-purchase-failure.png
diff --git a/articles/oracle/oracle-db/onboard-oracle-database.md b/articles/oracle/oracle-db/onboard-oracle-database.md
diff --git a/articles/oracle/oracle-db/oracle-database-autonomous-database-services.md b/articles/oracle/oracle-db/oracle-database-autonomous-database-services.md
@@ -1,18 +1,18 @@
 ---
-title: Autonomous database services
-description: Learn about autonomous database services.
+title: Autonomous database services for Oracle Database@Azure
+description: Learn about autonomous database services for Oracle Database@Azure.
 author: jjaygbay1
 ms.author: jacobjaygbay
 ms.topic: concept-article
 ms.service: oracle-on-azure
 ms.date: 08/01/2024
 ---
 
-# Autonomous database services
+# Autonomous database services for Oracle Database@Azure
 
 Oracle Database@Azure (OracleDB@Azure) provides you with a seamless integration of Oracle Autonomous Database resources within your Microsoft Azure cloud environment.
 
-You access the OracleDB@Azure service through the Microsoft Azure Portal. You create and manage Oracle Autonomous Database resources. For additional Autonomous Database functionality, you have direct access to the Oracle Cloud Infrastructure (OCI) portal.
+You access the OracleDB@Azure service through the Microsoft Azure portal. You create and manage Oracle Autonomous Database resources. For additional Autonomous Database functionality, you have direct access to the Oracle Cloud Infrastructure (OCI) portal.
 
 There are IP address requirement differences between Oracle Database@Azure and Oracle Cloud Infrastructure (OCI).
 * Oracle Database@Azure reserves 13 IP addresses for the client subnet versus 3 for OCI requirements.
@@ -27,4 +27,4 @@ The following articles provide specifics of the creation and management tasks as
 * [Terraform/OpenTofu examples for Autonomous Database services](oracle-database-examples-autonomous-database-services.md)
 * [Troubleshoot autonomous database services](oracle-database-troubleshoot-autonomous-database-services.md)
 
-For more information on specific Oracle Autonomous Database topics beyond their implementation and use within OracleDB@Azure, see [Using Oracle Autonomous Database Serverless](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/index.html).
+For more information on specific Oracle Autonomous Database articles beyond their implementation and use within OracleDB@Azure, see [Using Oracle Autonomous Database Serverless](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/index.html).
diff --git a/articles/oracle/oracle-db/oracle-database-delegated-subnet-limits.md b/articles/oracle/oracle-db/oracle-database-delegated-subnet-limits.md
@@ -1,5 +1,5 @@
 ---
-title: Delegated subnet limits
+title: Delegated subnet limits for Oracle Database@Azure
 description: Learn about Delegated subnet limits for Oracle Database@Azure.
 author: jjaygbay1
 ms.author: jacobjaygbay
@@ -8,7 +8,7 @@ ms.service: oracle-on-azure
 ms.date: 08/01/2024
 ---
 
-# Delegated subnet limits 
+# Delegated subnet limits for Oracle Database@Azure
 
 In this article, you learn about delegated subnet limits for Oracle Database@Azure.
 
diff --git a/articles/oracle/oracle-db/oracle-database-examples-autonomous-database-services.md b/articles/oracle/oracle-db/oracle-database-examples-autonomous-database-services.md
@@ -1,14 +1,14 @@
 ---
-title: Terraform/OpenTofu examples for autonomous database services
-description: Learn about Terraform/OpenTofu examples for autonomous database services.
+title: Terraform/OpenTofu examples for Oracle Database@Azure services
+description: Learn about Terraform/OpenTofu examples for Oracle Database@Azure services.
 author: jjaygbay1
 ms.author: jacobjaygbay
 ms.topic: concept-article
 ms.service: oracle-on-azure
 ms.date: 08/01/2024
 ---
 
-# Terraform/OpenTofu examples for autonomous database services
+# Terraform/OpenTofu examples for Oracle Database@Azure services
 
 Using HashiCorp Terraform, you can provision and manage resources for Oracle Database@Azure using the Terraform tool that enables you to provision and manage infrastructure in Oracle Cloud Infrastructure (OCI).
 
@@ -23,9 +23,7 @@ For more information on reference implementations for Terraform or OpenTofu modu
 The samples use example values for illustration purposes. You must replace them with your own settings.
 The samples use [AzAPI Dynamic Properties](https://techcommunity.microsoft.com/t5/azure-tools-blog/announcing-azapi-dynamic-properties/ba-p/4121855) instead of `JSONEncode` for more native Terraform behavior.
 
-## Oracle Autonomous Database Services
-
-### Create delegated subnet for Oracle Database@Azure
+## Create delegated subnet for Oracle Database@Azure
 
 ```resource "azurerm_resource_group" "resource_group" {
   location = "eastus"
@@ -59,7 +57,7 @@ module "avm_odbas_network" {
 }
 ```
 
-### Create an Oracle Autonomous Database
+## Create an Oracle Autonomous Database
 
 ```terraform {
   required_providers {
diff --git a/articles/oracle/oracle-db/oracle-database-get-started.md b/articles/oracle/oracle-db/oracle-database-get-started.md
@@ -11,7 +11,7 @@ ms.author: jacobjaygbay
 
 # Get started with Oracle Database@Azure
 
-In this article, you learn learn how to purchase and use Oracle Database@Azure.
+In this article, you learn about how to purchase and use Oracle Database@Azure.
 
 Oracle Database@Azure is an Oracle database service running on Oracle Cloud Infrastructure (OCI), colocated in Microsoft data centers. This ensures that the Oracle Database@Azure service has the fastest possible access to Azure resources and applications.
 
diff --git a/articles/oracle/oracle-db/oracle-database-groups-roles.md b/articles/oracle/oracle-db/oracle-database-groups-roles.md
@@ -40,8 +40,8 @@ Use the following groups in your Oracle Cloud Infrastructure (OCI) tenancy.
 ## Required IAM policies
 The following IAM policies are needed for Oracle Database@Azure users or groups:
 
-`` Allow any-user to use tag-namespaces in tenancy where request.principal.type = ‘multicloudlink’
-Allow any-user to manage tag-defaults in tenancy where request.principal.type = ‘multicloudlink’``
+- ``Allow any-user to use tag-namespaces in tenancy where request.principal.type = ‘multicloudlink’``
+- `` Allow any-user to manage tag-defaults in tenancy where request.principal.type = ‘multicloudlink’``
 
 For information on working with policies, see [Getting Started with Policies](https://docs.oracle.com/en-us/iaas/Content/Identity/policiesgs/get-started-with-policies.htm).
 
diff --git a/articles/oracle/oracle-db/oracle-database-known-issues.md b/articles/oracle/oracle-db/oracle-database-known-issues.md
@@ -54,7 +54,7 @@ The failure occurs because the user performing the action doesn't have  permissi
 
 ### Create 'OracleSubscription' resource fails with 'deny' Policy Action during offer purchase 
 
-**Details:** When subscribing Oracle Database@Azure,  must create a Managed Resource Group (MRG) in the background to contain the `OracleSubscription` object for billing purposes. This MRG must be in the  `EastUS` region with a specific name, and without tags initially.
+**Details:** When subscribing to Oracle Database@Azure,  must create a Managed Resource Group (MRG) in the background to contain the `OracleSubscription` object for billing purposes. This MRG must be in the  `EastUS` region with a specific name, and without tags initially.
 
 Any  policy that blocks the creation of the MRG triggers the error. For example, a policy with any of the following rules could cause the buy to fail:
 
@@ -72,11 +72,11 @@ The resource write operation failed to complete successfully, because it reached
 
 1.  Identify the blocking policy by examining the **Activity log**. In the log, you might see **'deny' Policy action** operation with the "failed" status:
 
-    :::image type="content" source="media/oaa-known-issue-purchase-failure-1.png" alt-text="The image shows the Azure activity log with a 'deny' Policy action that has caused a failure for the OracleSubscriptions_Update operation.":::
+    :::image type="content" source="media/deny-known-issue-purchase-failure.png" alt-text="The image shows the Azure activity log with a 'deny' Policy action that has caused a failure for the OracleSubscriptions_Update operation.":::
 
     The following image shows the details of the **'deny' Policy action** in the Azure portal:
 
-    :::image type="content" source="media/oaa-known-issue-purchase-failure-2.png" alt-text="The image shows a JSON file with example policies, including a policy limiting the allowed locations for resource groups.":::
+    :::image type="content" source="media/example-known-issue-purchase-failure.png" alt-text="The image shows a JSON file with example policies, including a policy limiting the allowed locations for resource groups.":::
 
 
 2.  Create a time-bound policy exemption for the blocking policies before trying to buy the offer and create the **OracleSubscription** resource again. For more information, see [Azure Policy exemption structure](/azure/governance/policy/concepts/exemption-structure) in the Azure documentation.
@@ -86,11 +86,11 @@ The resource write operation failed to complete successfully, because it reached
 
     Select **Create exemption** on the Policy Assignments page in the Azure portal:
 
-    :::image type="content" source="media/oaa-known-issue-purchase-failure-3.png" alt-text="The image shows the Create exemption button in the Azure portal Policy.":::
+    :::image type="content" source="media/exemption-known-issue-purchase-failure.png" alt-text="The image shows the Create exemption button in the Azure portal policy.":::
 
 3.  On the **Create exemption** page in the Azure portal, create a policy exemption. Use the **Expiration date** field to limit the time window for the policy exemption.
 
-    :::image type="content" source="media/oaa-known-issue-purchase-failure-4.png" alt-text="The image shows the Azure portal Create exemption workflow.":::
+    :::image type="content" source="media/workflow-known-issue-purchase-failure.png" alt-text="The image shows the Azure portal Create exemption workflow.":::
 
 
 
diff --git a/articles/oracle/oracle-db/oracle-database-manage-autonomous-database-resources.md b/articles/oracle/oracle-db/oracle-database-manage-autonomous-database-resources.md
@@ -1,14 +1,14 @@
 ---
-title: Manage autonomous database resources
-description: Learn about how to manage autonomous database resources.
+title: Manage autonomous database resources for Oracle Database@Azure
+description: Learn about how to manage autonomous database resources for Oracle Database@Azure.
 author: jjaygbay1
 ms.author: jacobjaygbay
 ms.topic: concept-article
 ms.service: oracle-on-azure
 ms.date: 08/01/2024
 ---
 
-# Manage autonomous database resources
+# Manage autonomous database resources for Oracle Database@Azure
 
 After provisioning any OracleDB@Azure resource, you can use the Microsoft Azure blade for a limited set of management functions.
 
@@ -91,10 +91,10 @@ The following management functions are available for all resources from the Micr
    1. **Username** - Enter **SYS**.
    1. **Password** - Enter the password used when creating the PDB.
    1. **Role** - Select **SYSDBA**.
-   1. **Save Password** - Select the box if you security rules allow. If not, you will need to enter the PDB password every time you use this connection in SQL Developer.
+   1. **Save Password** - Select the box if your security rules allow. If not, you will need to enter the PDB password every time you use this connection in SQL Developer.
    1. **Connection Type** - Select **Cloud Wallet**.
    1. **Configuration File** - Select **Browse**, and select the wallet you downloaded.
-   1. Select the **Test** button. The **Status** at the bottom of the connections list, should show as **Success**. If the connection is not a success, the wallet is out of date, or the ADB is not currently running.
+   1. Select the **Test** button. The **Status** at the bottom of the connections list should show as **Success**. If the connection is not a success, the wallet is out of date, or the ADB is not currently running.
    1. Select the **Save** button.
    1. Select the **Connect** button.
 
diff --git a/articles/oracle/oracle-db/oracle-database-network-plan.md b/articles/oracle/oracle-db/oracle-database-network-plan.md
@@ -1,8 +1,8 @@
 ---
 title: Network planning for Oracle Database@Azure
+description: Learn about Network planning for Oracle Database@Azure. 
 author: jjaygbay1
 ms.author: jacobjaygbay
-description: Learn about topologies and constraints for Oracle Database@Azure. 
 ms.topic: conceptual
 ms.service: oracle-on-azure
 ms.custom: engagement-fy23
diff --git a/articles/oracle/oracle-db/oracle-database-oci-azure-autonomous-database-services.md b/articles/oracle/oracle-db/oracle-database-oci-azure-autonomous-database-services.md
@@ -13,18 +13,19 @@ ms.date: 08/01/2024
 
 Oracle Cloud Infrastructure (OCI) partnered with Microsoft Azure to develop and distribute HashiCorp Terraform/OpenTofu modules that streamline the provisioning process.
 
-When you use both OCI Multicloud Landing Zone for Azure (OCI LZ) and Microsoft Verified Modules (MVM), multiple templates empower Oracle Database@Azure. These Terraform/OpenTofu modules use four (4) terraform providers, AzureRM, AzureAD, AzAPI, and OCI, covering IAM, networking, and database layer resources. Apply these reference implementations for a quick start deployment, or customize them for a more complex topology fit to your needs.
+When you use both OCI Multicloud Landing Zone for Azure (OCI LZ) and Azure Verified Modules (MVM), multiple templates empower Oracle Database@Azure. These Terraform/OpenTofu modules use four (4) terraform providers, AzureRM, AzureAD, AzAPI, and OCI, covering IAM, networking, and database layer resources. Apply these reference implementations for a quick start deployment, or customize them for a more complex topology fit to your needs.
 
 The following diagram illustrates where Terraform or OpenTofu can be introduced to streamline the identity, access, networking, and provisioning processes within Oracle Database@Azure.
 
-:::image type="content" source="media/architecture-diagram.png" alt-text="Architectural diagram of the Terraform components":::
+:::image type="content" source="media/architecture-diagram.png" alt-text="Architectural diagram of the Terraform components.":::
 
 
 ## Prerequisites
-1. Complete, at a minimum, steps 1-2 of the [Onboarding with Oracle Database@Azure](https://docs.oracle.com/iaas/Content/multicloud/oaaonboard.htm).
-1. Have a Terraform/OpenTofu, OCI CLI, Azure CLI, and python (minimum 3.4) environment. For more information, see the [Oracle Multicloud Landing Zone for Azure README](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure?tab=readme-ov-file#prerequisites).
 
-### Dependencies
+- Complete, at a minimum, steps 1-2 of the [Onboarding with Oracle Database@Azure](https://docs.oracle.com/iaas/Content/multicloud/oaaonboard.htm).
+-  Have a Terraform/OpenTofu, OCI CLI, Azure CLI, and python (minimum 3.4) environment. For more information, see the [Oracle Multicloud Landing Zone for Azure README](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure?tab=readme-ov-file#prerequisites).
+
+## Dependencies
 The [Oracle Multicloud Landing Zone for Azure](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure) modules and templates use multiple Terraform providers.
 
 | Terraform/OpenTofu Providers | Terraform/OpenTofu Modules |
@@ -34,29 +35,29 @@ The [Oracle Multicloud Landing Zone for Azure](https://github.com/oracle-quickst
 | [AzureRM](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs) |   |
 | [OCI](https://registry.terraform.io/providers/oracle/oci/latest/docs) |   |
 
-### Templates
+## Templates
 Refer to [Oracle Multicloud Landing Zone for Azure](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure) for module details.
 
 | Template | Use Case and Configurations | Terraform/OpenTofu Providers |
 | -------- | --------------------------- | ---------------------------- |
 | [az-oci-adbs](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure/tree/main/templates/az-oci-adbs) | **Quick start Autonomous Database** | [hashicorp/azurerm](https://registry.terraform.io/providers/hashicorp/azurerm) |
-|   | 1. Configuring Azure virtual network with [delegated subnet limits](https://docs.oracle.com/iaas/Content/database-at-azure/oaa-delegated-subnets-limits.htm) | [azure/api](https://registry.terraform.io/providers/Azure/azapi) |
+|   | 1. Configure Azure virtual network with [delegated subnet limits](https://docs.oracle.com/iaas/Content/database-at-azure/oaa-delegated-subnets-limits.htm) | [azure/api](https://registry.terraform.io/providers/Azure/azapi) |
 |   | 2. [Provision an Autonomous Database](oracle-database-provision-autonomous-database.md) |   |
 | [az-oci-rbac-n-sso-fed](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure/tree/main/templates/az-oci-rbac-n-sso-fed) | Set up both identity federation and RBAC roles/groups | All the following |
 | [az-oci-sso-federation](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure/tree/main/templates/az-oci-sso-federation) | Set up [SSO Between OCI and Microsoft Entra ID](https://docs.oracle.com/iaas/Content/Identity/tutorials/azure_ad/sso_azure/azure_sso.htm) | [hashicorp/azuread](https://registry.terraform.io/providers/hashicorp/azuread/) |
 |   | 1. Get service provider metadata from OCI IAM. | [hashicorp/azurerm](https://registry.terraform.io/providers/hashicorp/azurerm) |
-|   | 2. Create an Entra ID application. | [hashicorp/oci](https://registry.terraform.io/providers/hashicorp/oci) |
-|   | 3. Set up SAML SSO for the Entra ID application. |  |
-|   | 4. Set up attributes and claims in the Entra ID application. |  |
-|   | 5. Assign a test user to the Entra ID application. |  |
-|   | 6. Enable the Entra ID application as the Identity Provider (IdP) for OCI IAM. |  |
-|   | 7. Set up [Identity Lifecycle Management Between OCI IAM and Entra ID](https://docs.oracle.com/iaas/Content/Identity/tutorials/azure_ad/lifecycle_azure/azure_lifecycle.htm#azure-lifecycle). |  |
+|   | 2. Create an Microsoft Entra ID application. | [hashicorp/oci](https://registry.terraform.io/providers/hashicorp/oci) |
+|   | 3. Set up SAML SSO for the Microsoft Entra ID application. |  |
+|   | 4. Set up attributes and claims in the Microsoft Entra ID application. |  |
+|   | 5. Assign a test user to the Microsoft Entra ID application. |  |
+|   | 6. Enable the Microsoft Entra ID application as the Identity Provider (IdP) for OCI IAM. |  |
+|   | 7. Set up [Identity Lifecycle Management Between OCI IAM and Microsoft Entra ID](https://docs.oracle.com/iaas/Content/Identity/tutorials/azure_ad/lifecycle_azure/azure_lifecycle.htm#azure-lifecycle). |  |
 | [az-odb-rbac](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure/tree/main/templates/az-odb-rbac) | Create [roles and groups in Azure](https://docs.oracle.com/iaas/Content/multicloud/oaagroupsroles.htm) for Exadata and Autonomous Database services. | [hashicorp/azuread](https://registry.terraform.io/providers/hashicorp/azuread/) |
 |   | 1. Create Azure role definition for ADBS Administrator role.| [hashicorp/azurerm](https://registry.terraform.io/providers/hashicorp/azurerm) |
-|   | 1. Create Azure group. |  |
-|   | 1. Create Azure role assignment. |  |
+|   | 2. Create Azure group. |  |
+|   | 3. Create Azure role assignment. |  |
 
-### More Terraform/OpenTofu resources
+## More Terraform/OpenTofu resources
 
 * [QuickStart Oracle Database@Azure with Terraform or OpenTofu Modules](https://docs.oracle.com/en/learn/dbazure-terraform/index.html)
 * [Terraform: Set Up OCI Terraform](https://docs.oracle.com/iaas/developer-tutorials/tutorials/tf-provider/01-summary.htm)
diff --git a/articles/oracle/toc.yml b/articles/oracle/toc.yml
@@ -47,6 +47,8 @@ items:
       href: oracle-db/provision-autonomous-oracle-databases.md
     - name: Manage autonomous database resources
       href: oracle-db/oracle-database-manage-autonomous-database-resources.md
+    - name: Autonomous database services for Oracle Database@Azure
+      href: oracle-db/oracle-database-autonomous-database-services.md
     - name: Operations processes for Autonomous Database services
       href: oracle-db/oracle-database-processes-autonomous-database-services.md
     - name: OCI multicloud landing zone for Azure
