updated urls

jjaygbay · jjaygbay · commit 233dcc758a35 · 2024-06-07T12:02:48.000-04:00
diff --git a/articles/oracle/oracle-db/provision-autonomous-oracle-database.md b/articles/oracle/oracle-db/provision-autonomous-oracle-database.md
@@ -10,7 +10,7 @@ ms.custom: engagement-fy24
 ms.author: jacobjaygbay
 ---
 
-# Provision Oracle Autonomous Databases
+# Provision Oracle autonomous databases
 
 This article discusses how provision and conduct basic management functions for an Oracle Autonomous Database Serverless instance from the Oracle Autonomous Database@Azure blade. More management functions are available within the Oracle Cloud Infrastructure (OCI) portal available via the link to that Oracle Autonomous Database from the Oracle Autonomous Database@Azure blade.
 
diff --git a/articles/oracle/oracle-db/provision-manage-oracle-resources.md b/articles/oracle/oracle-db/provision-manage-oracle-resources.md
@@ -11,9 +11,9 @@ ms.author: jacobjaygbay
 ---
 # Manage resources for Oracle Database@Azure
 
-After provisioning an OracleDB@Azure resource, for example an Oracle Exadata Infrastructure or an Oracle Exadata VM Cluster, you can use the Microsoft Azure blade for a limited set of management functions, and those functions are described in this document.
+After you provision an OracleDB@Azure resource, for example an Oracle Exadata Infrastructure or an Oracle Exadata VM Cluster, you can use the Microsoft Azure blade for a limited set of management functions. That limited set of management functions is described in this document.
 
-## Common Management Functions from the Microsoft Azure Blade
+## Common management functions from the Microsoft Azure Blade
 
 The following management functions are available for all resources from the Microsoft Azure blade for that resource.
 
@@ -23,7 +23,7 @@ The following management functions are available for all resources from the Micr
    1. If the blade lists and manages several resources, select the resource type at the top of the blade. For example, the __Oracle Exadata Database@Azure__ blade accesses both Oracle Exadata Infrastructure and Oracle Exadata VM Cluster resources.
 * __List and see the status for all the resources of the same type.__
    1. Follow the steps to access the resource blade.
-   1. Resources will be shown in the list as __Succeeded__, __Failed__, or __Provisioning__.
+   1. Resources are shown in the list as __Succeeded__, __Failed__, or __Provisioning__.
    1. Access the specifics of that resource by selecting the link in the __Name__ field in the table.
 * __Provision a new resource of the same type.__
    1. Follow the steps to access the resource blade.
@@ -44,30 +44,33 @@ The following management functions are available for all resources from the Micr
    1. From the __Move resources__ page, use the drop-down field for __Resource group__ to select an existing resource group.
    1. To create and use a new resource group, select the __Create new__ link below the Resource group field. Enter a new resource group name in the __Name__ field. Select the __OK__ button to save your new resource group and use it. Select the __Cancel__ button to return without creating a new resource group.
 * __Move the resource to a new subscription.__
-[!NOTE]
-You must have access to another Microsoft Azure subscription, and that subscription must have been setup for access to OracleDB@Azure. If both of these conditions are not met, you will not be able to successfully move the resource to another subscription.
+
+> [!NOTE]
+> You must have access to another Microsoft Azure subscription, and that subscription must have been setup for access to OracleDB@Azure. If both of these conditions are not met, you will not be able to successfully move the resource to another subscription.
+
    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 overview page, select the __Move__ link on the Subscription field.
    1. From the __Move resources__ page, use the drop-down field for __Subscription__ to select an existing subscription.
-   1. You can also simultaneously move the resource group for the resource. To do this, note the steps in the __Move the resource to a new resource group__ tasks.
-* __Add, manage, or delete tags for the resource.__
+   1. You can also simultaneously move the resource group for the resource. To do this, note the steps in the __Move the resource to a new resource group__ tasks. __Add, manage, or delete tags for the resource.__
    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 overview page, select the __Edit__ link on the __Tags__ field.
    1. To create a new tag, enter values in the __Name__ and __Value__ fields.
    1. To edit an existing tag, change the value in the existing tag's __Value__ field.
    1. To delete an existing tag, select the __Trashcan__ icon at the right-side of the tag.
-* __Manage Resource Allocation for Oracle Autonomous Database Serverless Instances.__
-[!NOTE]
-You can only change the resource allocation settings for Oracle Autonomous Database Serverless instances using these steps. This does not apply to any other resource type.
+     * __Manage Resource Allocation for Oracle Autonomous Database Serverless Instances.__
+
+> [!NOTE]
+> You can only change the resource allocation settings for Oracle Autonomous Database Serverless instances using these steps. This does not apply to any other resource type.
+
    1. Follow the steps to access the Oracle Autonomous Database@Azure blade.
    1. Select the link to the resource from the __Name__ field in the table.
    1. From the resource's overview page, select the __Setting__ link left-menu, and then the __Resource allocation__ link.
    1. Select the __Manage__ button at the top of the Resource allocation page.
    1. From the __Manage resource allocation__ window, you can set the __ECPU count__ from 2 to 512. The __Compute auto scaling__ checkbox allows you to enable your Oracle Autonomous Database to scale its computing allocation automatically up to 512. The __Storage__ is a slider UI that allows setting the Storage allocation from 1 TB to 384 TB. The __Storage auto scaling__ checkbox allows you to enable your Oracle Autonomous Database to scale its storage allocation automatically up to 384 TB.
    1. After you have set or reviewed the fields, select the __Apply__ or __Cancel__ button as appropriate.
-* __Use the OCI console for complete management of the resource.__
+     * __Use the OCI console for complete management of the resource.__
    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.
diff --git a/articles/oracle/oracle-db/provision-oracle-database.md b/articles/oracle/oracle-db/provision-oracle-database.md
@@ -1,6 +1,6 @@
 ---
 title: Provision and manage Oracle Database@Azure
-description: Provision and Manage Oracle Database@Azure.
+description: Provision and manage Oracle Database@Azure.
 author: jjaygbay1
 ms.service: oracle-on-azure
 ms.collection: linux
@@ -21,19 +21,17 @@ There are IP address requirement differences between Oracle Database@Azure and O
 * Oracle Database@Azure only supports Exadata X9M. Other shapes are unsupported.
 * Oracle Database@Azure reserves 13 IP addresses for the client subnet versus 3 for OCI requirements.
 
-The following topics provide specifics of the creation and management tasks associated with each resource type.
+The following topics provide detailed information about creating and managing tasks associated with each resource type.
 
-Topics:
-
-* [Provisioning Exadata Infrastructure](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-provisioning-exadata-infrastructure.html#GUID-9CD7A523-0945-4B89-B688-C2EC3DA8F332)
-
-* [Provisioning an Exadata VM Cluster](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-provisioning-exadata-vm-cluster.html#GUID-3C953575-8D5E-470E-8C3A-5229A73E10CC)
-* [Provisioning Oracle Autonomous Databases](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-provisioning-autonomous-database.html#GUID-C5B35802-13A6-4531-93AD-5726868C9918)
-* [Using Terraform](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-using-terraform.html#GUID-10CF47A1-F8E5-4EEF-AE36-9855CA896125)
-* [Managing Resources](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-managing-resources.html#GUID-75B01ABA-B721-4E69-923E-F4513A510CE1)
-* [Provisioning Troubleshooting](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-provisioningtroubleshooting.html#GUID-DACCA740-025E-4466-8BB7-AC8C1D23E450)
+* [Provision Exadata infrastructure](provision-oracle-exadata-infrastructure.md)
+* [Provision an Exadata VM Cluster](provision-oracle-exadata-vm-cluster.md)
+* [Provision Oracle autonomous databases](provision-oracle-autonomous-databases.md)
+* [Use HashiCorp Terraform to provision Oracle Database@Azure](provision-use-terraform-oracle-database.md)
+* [Manage resources for Oracle Database@Azure](provision-manage-oracle-resources.md)
+* [Troubleshoot provisioning issues](provision-troubleshoot-oracle-database.md)
 
 For more information on specific database topics beyond their implementation and use within OracleDB@Azure, see the following topics:
+
 * [Exadata Database Service on Dedicated Infrastructure](https://docs.oracle.com/en/engineered-systems/exadata-cloud-service/ecscm/index.html#Oracle%C2%AE-Cloud)
 * [Manage Databases on Exadata Cloud Infrastructure](https://docs.oracle.com/en/engineered-systems/exadata-cloud-service/ecscm/manage-databases.html#GUID-51424A67-C26A-48AD-8CBA-B015F88F841A)
 * [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/provision-oracle-exadata-infrastructure.md b/articles/oracle/oracle-db/provision-oracle-exadata-infrastructure.md
@@ -1,6 +1,6 @@
 ---
-title: Provision Exadata Infrastructure for Oracle Database@Azure
-description: Provision Exadata Infrastructure for Oracle Database@Azure
+title: Provision Exadata infrastructure for Oracle Database@Azure
+description: Provision Exadata infrastructure for Oracle Database@Azure
 author: jjaygbay1
 ms.service: oracle-on-azure
 ms.collection: linux
@@ -10,12 +10,12 @@ ms.custom: engagement-fy23
 ms.author: jacobjaygbay
 ---
 
-# Provision Exadata Infrastructure
+# Provision Exadata infrastructure
 
 Provisioning Oracle Exadata Infrastructure is a time-consuming process. Provisioning an Oracle Exadata Infrastructure is a prerequisite for provisioning Oracle Exadata VM Clusters and any Oracle Exadata Databases.
 
-[!NOTE]
-Review the [Provisioning Troubleshooting](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-provisioningtroubleshooting.html#GUID-DACCA740-025E-4466-8BB7-AC8C1D23E450), specifically the IP Address Requirement Differences, to ensure you have all the information needed for a successful provisioning flow.
+> [!NOTE]
+> To ensure you have all the information needed for a successful provisioning flow, review the [Provisioning Troubleshooting](https://docs.oracle.com/en-us/iaas/odaaz/odaaz-provisioningtroubleshooting.html#GUID-DACCA740-025E-4466-8BB7-AC8C1D23E450) document specifically the IP Address Requirement Differences.
 
 1. Provision your Oracle Exadata Infrastructure and Oracle Exadata VM Cluster resources from the OracleDB@Azure blade. By default, the Oracle Exadata Infrastructure tab is selected. To create a Oracle Exadata VM Cluster resource, select that tab first.
 1. Select the __+ Create__ icon at the top of the blade to begin the provisioning flow.
diff --git a/articles/oracle/oracle-db/provision-oracle-exadata-vm-cluster.md b/articles/oracle/oracle-db/provision-oracle-exadata-vm-cluster.md
@@ -1,6 +1,6 @@
 ---
-title: Provision an Exadata VM Cluster for Oracle Database@Azure
-description: Provision an Exadata VM Cluster for Oracle Database@Azure.
+title: Provision an Exadata VM Cluster
+description: Provision an Exadata VM Cluster.
 author: jjaygbay1
 ms.service: oracle-on-azure
 ms.collection: linux
@@ -11,7 +11,7 @@ ms.author: jacobjaygbay
 ---
 
 
-# Provision an Exadata VM Cluster for Oracle Database@Azure
+# Provision an Exadata VM Cluster
 
 Provisioning an Oracle Exadata VM Cluster requires the existence of an Oracle Exadata Infrastructure, and is a prerequisite for Oracle Exadata Databases that runs on the cluster.
 
diff --git a/articles/oracle/oracle-db/provision-troubleshoot-oracle-database.md b/articles/oracle/oracle-db/provision-troubleshoot-oracle-database.md
@@ -1,6 +1,6 @@
 ---
-title: Provision troubleshooting for Oracle Database@Azure
-description: Provision troubleshooting for Oracle Database@Azure.
+title: Troubleshoot provisioning issues
+description: Troubleshoot provisioning issues.
 author: jjaygbay1
 ms.service: oracle-on-azure
 ms.collection: linux
@@ -10,7 +10,7 @@ ms.custom: engagement-fy23
 ms.author: jacobjaygbay
 ---
 
-# Provision troubleshooting for Oracle Database@Azure
+# Troubleshoot provisioning issues
 
 Use the information in this section to resolve common errors and provisioning issues in your Oracle Database@Azure environments.
 
@@ -23,5 +23,6 @@ Oracle advises removal of all Microsoft Azure locks to Oracle Database@Azure res
 ## IP Address Requirement Differences
 
 There are IP address requirement differences between Oracle Database@Azure and Oracle Cloud Infrastructure (OCI). In the Requirements for IP Address Space documentation, the following changes for Oracle Database@Azure must be considered.
+
 * Oracle Database@Azure only supports Exadata X9M. All other shapes are unsupported.
 * Oracle Database@Azure reserves 13 IP addresses for the client subnet versus 3 for OCI requirements.
diff --git a/articles/oracle/oracle-db/provision-use-terraform-oracle-database.md b/articles/oracle/oracle-db/provision-use-terraform-oracle-database.md
@@ -12,18 +12,18 @@ ms.author: jacobjaygbay
 
 # Use HashiCorp Terraform to provision Oracle Database@Azure
 
-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).
+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).
 
 The OCI mechanism for Terraform provisioning and management is done via JSON scripts. Here are sample scripts.
 
 >[!NOTE]
 >This document describes examples of provisioning and management of Oracle Database@Azure resources through Terraform provider AzAPI. See the [The AzAPI TF provider resources and data sources](https://registry.terraform.io/providers/Azure/azapi/latest/docs).
 
-The API spec version used in the examples is "2023-09-01-preview" as denoted in the "type" field in the examples. This will be changed to the public version when its made available.
+The API spec version used in the examples is "2023-09-01-preview" as denoted in the "type" field in the examples. This is changed to the public version when it's made available.
 
 ## Create an Oracle Exadata Infrastructure
 
-```azurecli
+```
 resource "azapi_resource" "resource_group" {
   type     = "Microsoft.Resources/resourceGroups@2023-07-01"
   name     = "ExampleRG"
@@ -60,10 +60,9 @@ resource "azapi_resource" "cloudExadataInfrastructure" {
 }
 ```
 
-### List Oracle Exadata Infrastructures by Subscription
-
-```azurecli
+## List Oracle Exadata Infrastructures by subscription
 
+```
 
 data "azapi_resource" "subscription" {
   type                   = "Microsoft.Resources/subscriptions@2020-06-01"
@@ -78,10 +77,9 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresBySubscription" {
 }
 ```
 
-List Oracle Exadata Infrastructures by Resource Group
-
-```dotnetcli
+## List Oracle Exadata Infrastructures by Resource Group
 
+```
 
 data "azurerm_resource_group" "example" {
   name = "existing"
@@ -95,13 +93,12 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresByResourceGroup" {
 }
 ```
 
-Patch an Oracle Exadata Infrastructure
+## Patch an Oracle Exadata Infrastructure
 
 > [!NOTE]
 > Only Microsoft Azure tags on the resource can be updated through the AzAPI provider.
 
-```dotnetcli
-
+```
 
 data "azapi_resource" "subscription" {
   type                   = "Microsoft.Resources/subscriptions@2020-06-01"
@@ -123,9 +120,9 @@ resource "azapi_resource_action" "patch_cloudExadataInfrastructure" {
 }
 ```
 
-### List Database Servers on an Oracle Exadata Infrastructure
+## List Database Servers on an Oracle Exadata Infrastructure
 
-```dotnetcli
+```
 
 // OperationId: DbServers_Get
 // GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudExadataInfrastructures/{cloudexadatainfrastructurename}/dbServers/{dbserverocid}
@@ -136,9 +133,9 @@ data "azapi_resource" "dbServer" {
 }
 ```
 
-Create an Oracle Exadata VM Cluster
+## Create an Oracle Exadata virtual machine cluster
 
-```dotnetcli
+```
 
 resource "azapi_resource" "resource_group" {
   type     = "Microsoft.Resources/resourceGroups@2023-07-01"
@@ -237,10 +234,9 @@ resource "azapi_resource" "cloudVmCluster" {
 }
 ```
 
-List Oracle Exadata VM Clusters by Subscription
-
-```dotnetcli
+## List Oracle Exadata virtual machine clusters by subscription
 
+```
 
 data "azapi_resource" "subscription" {
   type                   = "Microsoft.Resources/subscriptions@2020-06-01"
@@ -255,9 +251,9 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresBySubscription" {
 }
 ```
 
-List Oracle Exadata VM Clusters by Resource Group
+## List Oracle Exadata VM Clusters by Resource Group
 
-```dotnetcli
+```
 data "azurerm_resource_group" "example" {
   name = "existing"
 }
@@ -270,9 +266,10 @@ data "azapi_resource_list" "listCloudExadataInfrastructuresByResourceGroup" {
 }
 ```
 
-### List Database Nodes on an Oracle Exadata VM Cluster
+## List Database Nodes on an Oracle Exadata VM Cluster
+
+```
 
-```dotnetcli
 // OperationId: DbNodes_Get
 // GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudVmClusters/{cloudvmclustername}/dbNodes/{dbnodeocid}
 data "azapi_resource" "dbNode" {
@@ -282,9 +279,9 @@ data "azapi_resource" "dbNode" {
 }
 ```
 
-### Add a Virtual Network Address to an Oracle Exadata VM Cluster
+## Add a Virtual Network Address to an Oracle Exadata VM Cluster
 
-```dotnetcli
+```
 // 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" {
@@ -301,10 +298,9 @@ resource "azapi_resource" "virtualNetworkAddress" {
 }
 ```
 
-### List Virtual Network Addresses on an Oracle Exadata VM Cluster
-
-```dotnetcli
+## List Virtual Network Addresses on an Oracle Exadata VM Cluster
 
+```
 
 // OperationId: VirtualNetworkAddresses_ListByCloudVmCluster
 // GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudVmClusters/{cloudvmclustername}/virtualNetworkAddresses
@@ -314,10 +310,9 @@ data "azapi_resource_list" "listVirtualNetworkAddressesByCloudVmCluster" {
 }
 ```
 
-### List an Oracle Exadata Database Shape
-
-```dotnetcli
+## List an Oracle Exadata Database shape
 
+```
 
 data "azapi_resource_id" "location" {
   type      = "Oracle.Database/locations@2023-12-12"
@@ -334,10 +329,9 @@ data "azapi_resource" "dbSystemShape" {
 }
 ```
 
-### List Oracle Exadata Database Shapes by Location
-
-```dotnetcli
+## List Oracle Exadata Database Shapes by location
 
+```
 
 // OperationId: DbSystemShapes_ListByLocation
 // GET /subscriptions/{subscriptionId}/providers/Oracle.Database/locations/{location}/dbSystemShapes
@@ -347,13 +341,12 @@ data "azapi_resource_list" "listDbSystemShapesByLocation" {
 }
 ```
 
-### Terraform Script to Test the examples
+## Terraform script to test the examples
 
 >[!NOTE]
 >The following script creates an Oracle Exadata Infrastructure and an Oracle Exadata VM Cluster using the AzAPI Terraform provider followed by creating an Oracle 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).
 
-```dotnetcli
-
+```
 
 terraform {
   required_providers {
