Addressed feedback

Author: jjaygbay

articles/oracle/oracle-db/exadata-examples-services.md

@@ -10,21 +10,23 @@ ms.date: 08/01/2024
 
 # Terraform/OpenTofu examples for Exadata 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).
+In this article, you learn about how to use HashiCorp Terraform, to 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).
 
 For more information on reference implementations for Terraform or OpenTofu modules, sees the following links:
 * [QuickStart Oracle Database@Azure with Terraform or OpenTofu Modules](https://docs.oracle.com/en/learn/dbazure-terraform/index.html)
 * [OCI Landing Zones](https://github.com/oci-landing-zones/)
 * [Azure Verified Modules](https://aka.ms/avm)
 
-__NOTE:__ This document describes examples of provisioning and management of Oracle Database@Azure resources through Terraform provider `AzAPI`. For detailed AzAPI provider resources and data sources documentation, see [https://registry.terraform.io/providers/Azure/azapi/latest/docs](https://registry.terraform.io/providers/Azure/azapi/latest/docs)
+ >[!NOTE]
+ > This document describes examples of provisioning and management of Oracle Database@Azure resources through Terraform provider `AzAPI`. For detailed AzAPI provider resources and data sources documentation, see [https://registry.terraform.io/providers/Azure/azapi/latest/docs](https://registry.terraform.io/providers/Azure/azapi/latest/docs)
+
 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 Exadata Services
-
+## Oracle Exadata services
+In this section, you will find examples of how to use the `AzAPI` provider to manage Oracle Exadata services in Azure.
 ### Exadata Infrastructure
-
+In this section, you will find examples of how to use the `AzAPI` provider to manage Oracle Exadata infrastructure in Azure.
 #### Create an Oracle Exadata Infrastructure
 ```resource "azapi_resource" "resource_group" {
   type     = "Microsoft.Resources/resourceGroups@2023-07-01"
@@ -61,7 +63,6 @@ resource "azapi_resource" "cloudExadataInfrastructure" {
   schema_validation_enabled = false
 }
 ```
-
 #### List Oracle Exadata Infrastructures by Subscription
 ```data "azapi_resource" "subscription" {
   type                   = "Microsoft.Resources/subscriptions@2020-06-01"
@@ -90,7 +91,9 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresByResourceGroup" {
 ```
 
 #### Patch an Oracle Exadata Infrastructure
-__NOTE:__ Only Microsoft Azure tags on the resource can be updated through the AzAPI provider.
+ >[!NOTE] 
+ > Only Microsoft Azure tags on the resource can be updated through the AzAPI provider.
+
 ```data "azapi_resource" "subscription" {
   type                   = "Microsoft.Resources/subscriptions@2020-06-01"
   response_export_values = ["*"]
@@ -111,7 +114,7 @@ resource "azapi_resource_action" "patch_cloudExadataInfrastructure" {
 }
 ```
 
-#### List Database Servers on an Oracle Exadata Infrastructure
+#### List database servers on an Oracle Exadata infrastructure
 ```// OperationId: DbServers_Get
 // GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudExadataInfrastructures/{cloudexadatainfrastructurename}/dbServers/{dbserverocid}
 data "azapi_resource" "dbServer" {
@@ -121,9 +124,9 @@ data "azapi_resource" "dbServer" {
 }
 ```
 
-### Exadata VM Cluster
+## Exadata VM Cluster
 
-#### Create an Oracle Exadata VM Cluster
+### Create an Oracle Exadata VM Cluster
 ```resource "azapi_resource" "resource_group" {
   type     = "Microsoft.Resources/resourceGroups@2023-07-01"
   name     = "ExampleRG"  location = "eastus"
@@ -220,7 +223,7 @@ resource "azapi_resource" "cloudVmCluster" {
 }
 ```
 
-#### List Oracle Exadata VM Clusters by Subscription
+### List Oracle Exadata VM Clusters by Subscription
 ```data "azapi_resource" "subscription" {
   type                   = "Microsoft.Resources/subscriptions@2020-06-01"
   response_export_values = ["*"]
@@ -234,7 +237,7 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresBySubscription" {
 }
 ```
 
-#### List Oracle Exadata VM Clusters by Resource Group
+### List Oracle Exadata VM Clusters by Resource Group
 ```data "azurerm_resource_group" "example" {
   name = "existing"
 }
@@ -247,7 +250,7 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresByResourceGroup" {
 }
 ```
 
-#### List Database Nodes on an Oracle Exadata VM Cluster
+### List Database Nodes on an Oracle Exadata VM Cluster
 ```// OperationId: DbNodes_Get
 // GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudVmClusters/{cloudvmclustername}/dbNodes/{dbnodeocid}
 data "azapi_resource" "dbNode" {
@@ -257,7 +260,7 @@ data "azapi_resource" "dbNode" {
 }
 ```
 
-#### Add a Virtual Network Address to an Exadata VM Cluster
+### Add a Virtual Network Address to an Exadata VM Cluster
 ```// OperationId: VirtualNetworkAddresses_CreateOrUpdate, VirtualNetworkAddresses_Get, VirtualNetworkAddresses_Delete
 // PUT GET DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudVmClusters/{cloudvmclustername}/virtualNetworkAddresses/{virtualnetworkaddressname}
 resource "azapi_resource" "virtualNetworkAddress" {
@@ -274,7 +277,7 @@ resource "azapi_resource" "virtualNetworkAddress" {
 }
 ```
 
-#### List Virtual Network Addresses on an Oracle Exadata VM Cluster
+### List Virtual Network Addresses on an Oracle Exadata VM Cluster
 ```// OperationId: VirtualNetworkAddresses_ListByCloudVmCluster
 // GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudVmClusters/{cloudvmclustername}/virtualNetworkAddresses
 data "azapi_resource_list" "listVirtualNetworkAddressesByCloudVmCluster" {
@@ -283,9 +286,9 @@ data "azapi_resource_list" "listVirtualNetworkAddressesByCloudVmCluster" {
 }
 ```
 
-### Exadata Database Shape
-
-#### List an Oracle Exadata Database Shape
+## Exadata Database Shape
+In this section, you will find examples of how to use the `AzAPI` provider to manage Oracle Exadata Database shapes in Azure.
+### List an Oracle Exadata Database Shape
 ```data "azapi_resource_id" "location" {
   type      = "Oracle.Database/locations@2023-12-12"
   parent_id = data.azapi_resource.subscription.id
@@ -310,9 +313,10 @@ data "azapi_resource_list" "listDbSystemShapesByLocation" {
 }
 ```
 
-### Combined Exadata Services
+## Combined Exadata Services
+In this section, you will find examples of how to use the `AzAPI` provider to manage Oracle Exadata services in Azure.
 
-#### Create an Oracle Database Home on an Exadata VM Cluster on an Exadata Infrastructure with a Delegated Subnet in Microsoft Azure
+### Create an Oracle Database Home on an Exadata VM Cluster on an Exadata Infrastructure with a Delegated Subnet in Microsoft Azure
 __NOTE:__ The following script creates an Oracle Exadata Infrastructure and an Oracle Exadata VM Cluster using the `AzAPI` Terraform provider followed by creating an Exadata Database deployment using the OCI Terraform provider ([https://registry.terraform.io/providers/oracle/oci/latest/docs/resources/database_db_home](https://registry.terraform.io/providers/oracle/oci/latest/docs/resources/database_db_home)).
 ```terraform {
   required_providers {

articles/oracle/oracle-db/exadata-manage-resources.md

@@ -16,13 +16,13 @@ After provisioning an OracleDB@Azure resource, for example an Oracle Exadata Inf
 
 There are prerequisites that must be completed before you can provision Exadata Services. You need to complete the following:
 
-1. An existing Azure subscription
-1. An Azure VNet with a subnet delegated to the Oracle Database@Azure service (`Oracle.Database/networkAttachments`)
-1. Permissions in Azure to create resources in the region, with the following conditions:
+- An existing Azure subscription
+- An Azure VNet with a subnet delegated to the Oracle Database@Azure service (`Oracle.Database/networkAttachments`)
+- Permissions in Azure to create resources in the region, with the following conditions:
    * No policies prohibiting the creation of resources without tags, because the OracleSubscription resource is created automatically without tags during onboarding.
    * No policies enforcing naming conventions, because the OracleSubscription resource is created automatically with a default resource name.
-1. Purchase OracleDB@Azure in the Azure portal.
-1. Select your Oracle Cloud Infrastructure (OCI) account.
+- Purchase OracleDB@Azure in the Azure portal.
+- Select your Oracle Cloud Infrastructure (OCI) account.
 For more detailed documentation, including optional steps, see [Onboarding with Oracle Database@Azure](https://docs.oracle.com/iaas/Content/database-at-azure/oaaonboard.htm).
 
 ## Common Management Functions from the Microsoft Azure Blade
@@ -76,13 +76,18 @@ The following management functions are available for all resources from the Micr
 1. From the resource's overview page, select the **Settings > Virtual machines** link on the left-side menu.
 1. To start a virtual machine (VM), select the **Start** icon. The **Start virtual machine** panel opens. Select the VM to start from the **Virtual machine** drop-down list. The drop-down list only populates with any unavailable VMs. Select the **Submit** button to start that VM, or the **Cancel** button to cancel the operation.
 1. To stop a virtual machine (VM), select the **Stop** icon. The **Stop virtual machine** panel opens. Select the VM to stop from the **Virtual machine** drop-down list. The drop-down list only populates with any available VMs. NOTE: Stopping a node may disrupt ongoing back-end software operations and database availability. Select the **Submit** button to stop that VM, or the **Cancel** button to cancel the operation.
-1. To restart a virtual machine (VM), select the **Restart** icon. The **Restart virtual machine** panel opens. Select the VM to restart from the Virtual machine drop-down list. The drop-down list only populates with any available VMs. **NOTE:** Restarting shuts down the node and then starts it. For single-node systems, databases are offline while the reboot is in progress. Select the **Submit** button to restart that VM, or the **Cancel** button to cancel the operation.
+1. To restart a virtual machine (VM), select the **Restart** icon. The **Restart virtual machine** panel opens. Select the VM to restart from the Virtual machine drop-down list. The drop-down list only populates with any available VMs.
+ 
+ >[!NOTE] 
+ >Restarting shuts down the node and then starts it. For single-node systems, databases are offline while the reboot is in progress.
+
+1. Select the **Submit** button to restart that VM, or the **Cancel** button to cancel the operation.
 
 ### Access the OCI console
 1. Follow the steps to **Access the resource blade**.
 1. Select the link to the resource from the **Name** field in the table.
 1. From the resource's detail page, select the **Go to OCI** link on the **OCI Database URL** field.
-1. Login to OCI.
+1. Log in to OCI.
 1. Manage the resource from within the OCI console.
 
 ### Perform a connectivity test
@@ -97,7 +102,7 @@ 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 **Basic**.
    1. **Hostname** - Enter one of the host IPs from the **Connection Strings** above.
    1. **Port** - The default is 1521. You only need to change this if you have altered default port settings for the PDB.
@@ -111,7 +116,7 @@ The following management functions are available for all resources from the Micr
 1. Follow the steps to access the Oracle Exadata VM Cluster resource blade.
 1. Select the link to the resource from the **Name** field in the table.
 1. From the resource's detail page, select the **Go to OCI** link on the **OCI network security group URL** field.
-1. Login to OCI.
+1. Log in to OCI.
 1. Manage the NSG rules from within the OCI console.
 1. For additional information on NSG rules and considerations within OracleDB@Azure, see the **Automatic Network Ingress Configuration** section of [Troubleshooting and Known Issues for Exadata Services](exadata-troubleshoot-services.md).
 

articles/oracle/oracle-db/exadata-multicloud-landing-zone-azure-services.md

@@ -12,19 +12,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.
 
-Both OCI Multicloud Landing Zone for Azure (OCI LZ) and Microsoft Verified Modules (MVM) use 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.
+Both OCI Multicloud Landing Zone for Azure (OCI LZ) and Microsoft Verified Modules (MVM) use multiple templates to 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 showing the Terraform components.":::
 
 
 ## Prerequisites
 
-1. Complete, at a minimum, steps 1-2 of the [Onboarding with Oracle Database@Azure](onboard-oracle-database.md).
-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).
+- Complete, at a minimum, steps 1-2 of the [Onboarding with Oracle Database@Azure](onboard-oracle-database.md).
+- 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
+## Dependencies
 
 The [Oracle Multicloud Landing Zone for Azure](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure) modules and templates use multiple Terraform providers.
 
@@ -35,7 +35,7 @@ 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
 
 For module details, see [Oracle Multicloud Landing Zone for Azure](https://github.com/oracle-quickstart/terraform-oci-multicloud-azure).
 
@@ -63,7 +63,7 @@ For module details, see [Oracle Multicloud Landing Zone for Azure](https://githu
 |  | 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)
 * [Import OCI Resources into a Terraform State File](https://docs.oracle.com/en/learn/terraform-statefile-oci-resources/index.html)

articles/oracle/oracle-db/exadata-operations-processes-services.md

@@ -27,7 +27,7 @@ Oracle Database Autonomous Recovery Service@Azure (RCV) is the preferred backup
 * Speeds recovery to regions with optimized backups eliminating the need to recover multiple incremental backups.
 * Centralizes database protection insights with a granular recovery health dashboard.
 
-### High-level Steps to Enable Autonomous Recovery Service@Azure
+## High-level Steps to Enable Autonomous Recovery Service@Azure
 
 1. Access the OCI console for the database you want to enable for Autonomous Recovery Service@Azure. For details on this, see Access the OCI console in [Managing Exadata Resources](exadata-manage-resources.md).
 1. Configure or create an Autonomous Recovery Service@Azure protection policy with Store backups in the same cloud provider as the database set.