Database Troubleshooting
Use the information in this section to resolve common errors and provisioning issues in the Oracle Database Service for Azure.
- Network CIDR Sizing
- Oracle Base Database Observability Provisioning Failure
- Reserved IP Addresses
- Submitting a Support Request
- Resolving the Metrics Icon Not Showing for a Database
- Resolving No Metrics Being Displayed for a Database
- Resolving a Service Limit (Quota) Issue
- Resolving Duplicate Subnet Names
Network CIDR Sizing
When you provision an Oracle Base Database, an Oracle Exadata VM Cluster, or a Oracle HeatWave with one or more HeatWave nodes, you specify an network address using CIDR notation, which is a range of networking addresses the service uses. Additionally, when you provision an Oracle Exadata System, which includes VMs and database nodes within it, you also specify a network address range with CIDR. This document explains how those CIDR ranges are used within Oracle Database Service for Azure, and how to select the appropriate space based on the service you are provisioning.
Oracle Autonomous Database Serverless (ADB-S) uses a different model for networking management, and is not impacted by these requirements.
When you specify the virtual cloud network (VCN) using CIDR notation, that is split into two subnets. Each subnet has only half of the specified CIDR range. Additionally, 5 IP addresses per subnet are reserved by Oracle Database Service for Azure, and are unavailable to the service you are provisioning. For more information on these reserved addresses, see Are there any restrictions on using IP addresses within these subnets?
Table 1-2 Number of available IPs per subnet
VCN CIDR | Subnet CIDR | IPs Reserved Per Subnet | IPs Available Per Subnet |
---|---|---|---|
/28 | /29 | 5 | 3 (2^3 - 5) |
/27 | /28 | 5 | 11 (2^4 - 5) |
/26 | /27 | 5 | 27 (2^5 - 5) |
/25 | /26 | 5 | 59 (2^6 - 5) |
/24 | /25 | 5 | 123 (2^7 - 5) |
/23 | /24 | 5 | 251 (2^8 - 5) |
/22 | /23 | 5 | 507 (2^9 - 5) |
This table helps you select an appropriate CIDR range for the specific service or services your VCN will support.
Table 1-3 Number of database systems or VM clusters supported
Selected CIDR Range | |||||||
---|---|---|---|---|---|---|---|
Shape | /28 | /27 | /26 | /25 | /24 | /23 | /22 |
Exadata X9M (max. 32 Nodes) | 0 | 0 | 0 | 0 | 0 | 1 | 3 |
Exadata X8M / X9M (8 Nodes) | 0 | 0 | 0 | 1 | 3 | 7 | 14 |
Exadata Base System / X8M / X9M (min. 2 Nodes) | 0 | 1 | 2 | 5 | 11 | 22 | 46 |
Oracle Base Database Two Nodes | 0 | 1 | 3 | 8 | 17 | 35 | 72 |
Oracle Base Database Single Node | 3 | 11 | 27 | 59 | 123 | 251 | 507 |
Oracle HeatWave Single Node | 1 | 5 | 13 | 29 | 61 | 125 | 253 |
Reserved = 5 // Azure reserves the first 4 IPs and last IP in the CIDR range
UsedIps = Number of IPs already in use in the subnet // Zero when creating a new McVCN
if ( (CidrSize - Reserved - UsedIps) < RequiredIps )
Error: CIDR size is insufficient to support the requested DB shape
If this happens, you will need to increase the size of the VCN for you requested shape.
Use the following table to compute the IP address requirements for your database shape.
Table 1-4 IPs required per database instance by shape
Database Shape | Number of IPs Required per Instance |
---|---|
Oracle Base Database Single Node | 1 |
Oracle Base Database Two Node | (2 * 2 nodes) + 3 SCAN = 7 |
Oracle HeatWave Single Node | 2 |
Exadata Base System / X8M / X9M (min. 2 Nodes) | (4 * 2 nodes) + 3 SCAN = 11 |
Exadata X8M / X9M (8 Nodes) | (4 * 8 nodes) + 3 SCAN = 35 |
Exadata X9M (max. 32 Nodes) | (4 * 32 nodes) + 3 SCAN = 131 |
Oracle Base Database Observability Provisioning Failure
Oracle Base Databases require, during provisioning, the capability to create or update a resource group and dashboard.
From the Microsoft Azure Portal, check the policies applied to the account. In order to successfully provision an Oracle Base Database, you cannot have a policy that prevents the creation or updates of resource groups. You also cannot have a policy that prevents the creation or updates of dashboards. If these exist, they must either be removed or relaxed in order for the Base Database to provision successfully.
Reserved IP Addresses
Database provisioning launch workflows can occasionally fail due to an IP address conflict issue when Multicloud Virtual Cloud Network (MCVCN) operates in automatic routing mode.
In automatic routing mode, Multicloud Virtual Cloud Network (MCVCN) configures an internal load balancer (ILB) in the leaf VNET, and assigns IP addresses given to a database node over in the Oracle Cloud Infrastructure (OCI) VCN side. This works well for most scenarios. Here is where and why it fails.
When the database IP address falls in one of first 4 IP addresses or the last IP address of the subnet range, Microsoft Azure rejects the private IP address configuration request. The first 4 IP addresses and the last IP addresses within a subnet range are reserved by Microsoft Azure (see Microsoft Azure Virtual Network FAQ).
As an example, assume that a subnet is spawned with a /24 CIDR, the most common subnet configuration, the CIDR means approximately 2% of the database provisioning launch workflows will fail because VCN randomly picked an IP address within a subnet. The failure rate is higher with a smaller CIDR subnet ranges.
The third and fourth IP addresses (which for 10.0.0.0/24 would be 10.0.0.2 and 10.0.0.3) are reserved in Microsoft Azure but usable in OCI. The database provisioning workflow automation has been adjusted to properly reserve these IP addresses. The issue will occur when manual configuration and incorporation of OCI resources is done.
Submitting a Support Request
To submit a support request, use the following steps.
- From the OracleDB for Azure Home page, select the Support icon.
- This is the Support requests page. You can create, view, and manage support requests assigned to your account. Select the Create a support request link to create a new request.
- This is the Problem description page of the Create support request flow. You can select options like Billing, Service and subscription limits (quotas), or Technical as appropriate.
- The pages that follow will vary based on the type of support request you are filing. There are three (3) pages to each type, the Problem description page, the Additional details page, and the Review + create page.
- On the Review + create page, the Create button, as shown, will only be enabled when you have entered acceptable values into all the required support request fields.
- Continue to monitor and respond to the request as needed on the Support requests portal.
Resolving the Metrics Icon Not Showing for a Database
From any database blade, you will see a Metrics icon in the row of management icons for that database. On a fully functioning database, that icon will be enabled. Here are some actions to take to resolve that issue.
- Check that your database provisioning is completed. This icon will not be enabled until provisioning completes. Wait for provisioning to complete.
- Check that your database provisioning completed successfully. Any errors during provisioning will stop the provisioning process. Resolve those errors. If necessary, submit a support request.
- Check that you are viewing a database with associated metrics. Pluggable databases (PDBs) do not produce metrics. For PDBs, you will have to select the container database (CDB) for your PDB.
Resolving No Metrics Being Displayed for a Database
If you select a database and open the Applications Insights Portal and the Metrics blade and no metrics are being displayed, here are some actions to take to resolve that issue.
- You have not selected an appropriate Metrics Namespace. By default, the metrics open in the Log-based metrics namespace. By default, the starting Metrics Namespace is the Log-based Metrics namespace. For an Oracle Autonomous Database Serverless, an Oracle Exadata Database, an Oracle Base Database, or a Oracle HeatWave Database, you will need to select the namespace as follows:
Table 1-5 Metrics Namespace
Database Type Metrics Namespace Oracle Autonomous Database Serverless oci_autonomous_database Oracle Exadata Database oci_database Oracle Base Database oci_database Oracle HeatWave Database oci_mysql_database - You have not selected an appropriate metric for your database. Select from the available metrics in the drop-down field.
- You have not selected an appropriate time and date range for your metrics.
- Your database is new, and the metrics are not yet available.
Resolving a Service Limit (Quota) Issue
When you reach the service limit (quota) for your account, you receive an error when you try to provision a new database. You must either submit a support request to increase your limit in order to provision that additional database, and wait until that is approved to provision, or you must terminate an existing database to free resources, like CPU or storage, sufficient for your new provisioning request.
- From the OracleDB for Azure Home page, select the Support icon.
- This is the Support requests page. You can create, view, and manage support requests assigned to your account. Select the Create a support request link to create a request to increase your service limits.
- This is the Problem description page of the Create support request flow. Select Service and subscription limits (quotas). If you have another type of support issue, you could select Billing or Technical, as needed.
- After selecting Service and subscription limits (quotas), you will need to select the type of database in the Quota type field. Then you will select the Next button.
- This is the Additional details page of the Create support request flow. You will enter the details of your quota request, the severity, and the contact information for this request. The contact can be anyone within your organization that is managing this issue. They should have access to this subscription to be able to track, manage, and respond to the request.
- Quota details will vary by the type of database. This is an example of the quota details for an Oracle Base Database quota increase.
- This is an example of the quota details for an Oracle Exadata Database quota increase.
- This is an example of the quota details for a Oracle Autonomous Database Serverless quota increase.
- This is an example of the quota details for a Oracle HeatWave quota increase.
- Regardless of the type of database quota being selected, you will also need to select the Region to where this quota increase will be applied, and the new requested value for the quota. Select the OK button when you have entered all of the quota details for your request.
- This is the Create + review page of the Create support request flow. If you have entered all the required information, the Create button will be enabled. If you have not entered all the required information or you wish to change any of the information you have entered, use the Previous button to return to the page where that information is entered. Select the Create button to submit your request. Continue to monitor and respond to the request as needed on the Support requests portal.
Resolving Duplicate Subnet Names
When provisioning an Oracle Base Database, you may not see your Microsoft Azure VNET in the list of available resources. If you don't see it in the list, your VNET cannot be peered with an Oracle Cloud Infrastructure (OCI) Multicloud Virtual Cloud Network (MCVCN) due to Microsoft Azure routing limitations.
To resolve this issue, do the following:
- Delete the Virtual Network Gateway (VNG) or Azure Route Server (ARS) associated with the VNET or any of its peered VNETs.
- Create a new VNET to peer with your OCI MCVCN.