Service Change Announcements

This section includes details about Oracle Cloud Infrastructure breaking changes, such as deprecated features, deprecated APIs, and service behavior changes.

Block Volume

Full backups removed from Oracle defined backup policies

Service Change: Oracle defined backup policies no longer include full volume backups.

Date Announced: November 3, 2020

Date in Effect: November 3, 2021

Details: Starting November 3, 2021, Oracle defined backup policies no longer include full volume backups. All volume backups generated from Oracle defined policies are now incremental backups. This change applies to existing volume backup policy assignments and new volume backup policy assignments. This change does not impact user defined policies, which remain unchanged.

Does this impact me? If you have assigned an Oracle defined policy to boot volumes or block volumes for scheduled backups, full backups are no longer generated after November 3, 2021.

What do I need to do? Incremental backups are functionally the same as full backups for data recovery purposes, for more information, see Volume Backup types. No action is needed for data recovery scenarios. Some compliance scenarios may require scheduled full backups. For these compliance scenarios, change the backup policy assignment to a user defined backup policy prior to November 1, 2021. You can create a new user defined policy from an existing backup policy, see Duplicating Existing Backup Policies.

Compute

PCI-NIC fault class for Compute bare metal instance health monitoring is deprecated

Service Change: The PCI-NIC fault class for Compute bare metal instance health monitoring is deprecated.

Date Announced: June 21, 2022

Date in Effect: June 21, 2023

Details: The PCI-NIC fault class provides information about a hardware issue with your bare metal instances, specifically when a fault in the instance network interface card (NIC) has been detected. The PCI-NIC fault class will no longer be emitted.

Does this impact me? When support ends, you will no longer receive health monitoring notifications for the PCI-NIC fault class. Infrastructure health metrics will no longer be emitted for the PCI-NIC fault class.

What do I need to do? Migrate to the PCI fault class for similar functionality. For more information, see Compute Health Monitoring for Bare Metal Instances and Infrastructure Health Metrics.

Database

Deprecated Exadata Database Service on Dedicated Infrastructure APIs

Oracle Cloud Infrastructure's Exadata DB system APIs were deprecated on November 15, 2020.

Important!: No new systems can be provisioned with the old DB system resource model/APIs after May 15th, 2021. Support for the old DB system resource model/APIs on existing systems will end on November 15th, 2021. Oracle recommends that you migrate your Exadata Database Service on Dedicated Infrastructure instances to the new resource model APIs as soon as possible. Converting to the new resource model does not involve any system downtime.

Unsupported API Replacement APIs
LaunchDbSystem (deprecated for Exadata systems only) CreateCloudExadataInfrastructure and CreateCloudVmCluster
ListDbSystems (deprecated for Exadata systems only) ListCloudExadataInfrastructures and ListCloudVmClusters
GetDbSystem (deprecated for Exadata systems only) GetCloudExadataInfrastructure and GetCloudVmCluster
ChangeDbSystemCompartment (deprecated for Exadata systems only) ChangeCloudExadataInfrastructureCompartment and ChangeCloudVmClusterCompartment
UpdateDbSystem (deprecated for Exadata systems only) UpdateCloudExadataInfrastructure and UpdateCloudVmCluster
GetExadataIormConfig (deprecated for Exadata systems only) GetCloudVmClusterIormConfig
UpdateExadataIormConfig (Exadata systems only) UpdateCloudVmClusterIormConfig
TerminateDbSystem (deprecated for Exadata systems only) DeleteCloudExadataInfrastructure and DeleteCloudVmCluster

Database Migration

Deprecated Database Migration APIs

Service Change: Oracle Cloud Infrastructure's Database Migration APIs of version 20200720 were deprecated on October 6, 2021.

Date Announced: October 6, 2021

Date in Effect: October 5, 2022

Details: Starting October 5, 2022, Database Migration APIs of version 20200720 is deprecated.

  • Any resource created with the deprecated version is automatically converted to the latest resource model (version 20210929). (Before this date, any created with the deprecated version remains accessible on its basePath of /20200720.)
  • OCI Console users are automatically migrated to the latest resource model (version 20210929).
  • OCI SDKs and command line tools that were released before October 6, 2021, are limited to the features of the deprecated resource model (version 20200720).
  • Database Migration Service Agent Kits that were downloaded before October 6, 2021, are limited to the features of the deprecated resource model (version 20200720).

Does this impact me? Yes, if you have an older client or agent kit.

What do I need to do?

List of unsupported and replacement APIs

DevOps

Deprecated DevOps APIs

Service Change: Oracle Cloud Infrastructure's DevOps APIs (two APIs) of version 20210630 were deprecated on March 29, 2022.

Date Announced: March 29, 2022

Date in Effect: March 29, 2023

Details: Starting March 29, 2022, two DevOps APIs of version 20210630 were deprecated. From March 29, 2023, onwards the deprecated APIs will be unavailable.

Functions

Fn Project CLI version 0.5.x (and earlier) no longer supported

Service Change: Fn Project CLI version 0.5.x (and earlier) will no longer be supported.

Date Announced: June 29, 2021

Date in Effect: August 1, 2021

Details: Starting August 1, 2021, Fn Project CLI version 0.5.x (and earlier) will no longer work with Oracle Functions.

Does this impact me? If you are currently using Fn Project CLI version 0.5.x (or earlier), you will need to upgrade to Fn Project CLI version 0.6.x (or later).

What do I need to do? Upgrade to Fn Project CLI version 0.6.x (or later), by following the instructions in Upgrading the Fn Project CLI.

Fn Project FDK build-time and runtime base images built on Oracle Linux 8 (Alpine/Debian FDK base images deprecated)

Service Change: From December 15, 2021, the Fn Project FDK (Function Development Kit) build-time and runtime base images, with the exception of the FDK for Python 3.7, are built on top of the Oracle Linux 8 slim distribution. The Alpine/Debian FDK base images are deprecated.

Date Announced: November 15, 2021

Date in Effect: December 15, 2021

Details: Starting December 15, 2021, most of the Fn Project FDK (Function Development Kit) build-time and runtime base images for the different supported languages are built on top of the Oracle Linux 8 slim distribution (instead of the Alpine and Debian Linux distributions). New functions you deploy will use these Oracle Linux 8 FDK base images. The only exceptions are the FDK build-time and runtime base images for Python 3.7, which continue to be built on top of the Debian Linux distribution.

The Alpine/Debian Linux distributions and the Oracle Linux 8 slim distribution have different package managers. After the transition to the Oracle Linux 8 FDK base images, the temporary Dockerfile created by Oracle Functions when deploying new functions contains Oracle Linux 8 package manager commands.

Does this impact me?

For existing functions already deployed to Oracle Functions:

  • If Oracle Functions uses the settings in a function's func.yaml file to create a temporary Dockerfile containing the instructions from which to build the function's Docker image, the function will build and deploy without errors. The temporary Dockerfile includes the correct Oracle Linux 8 package manager commands.
  • If you have created a custom Dockerfile for a function (for example, by modifying the Dockerfile that Oracle Functions creates, and setting runtime: docker in the function's func.yaml file), the function might now build and deploy with errors such as missing apt-get .... The errors occur if the custom Dockerfile includes Alpine/Debian package manager commands.

What do I need to do? If you have created custom Dockerfiles that contain Alpine/Debian package manager commands, replace those commands with Oracle Linux 8 package manager commands.

If you cannot immediately start using the Oracle Linux 8 FDK base images because you have functions that still require the Alpine or Debian Linux distributions, there is a temporary workaround. Until December 15, 2022, the Alpine/Debian FDK base images remain available but with modified image tags. You can update custom Dockerfiles to use the deprecated Alpine/Debian FDK base images instead of the Oracle Linux 8 base images by explicitly specifying the modified image tags. See My functions still require the Alpine and Debian Linux distributions. Is there a temporary workaround?.

Java Management Service (JMS)

Custom log required for JMS Fleet creation

Service Change: Effective July 15, 2022, the CreateFleet API will require the custom log OCID in the inventoryLog property.

Date Announced: April 15, 2022

Date in Effect: July 15, 2022

Details: As of March 30, 2022, JMS uses the Oracle Cloud Infrastructure Logging service to store inventory and operation logs. Inventory logs are custom logs that store the Java Runtime inventory and usage related information reported from the hosts by the Management Agent. With this change, the CreateFleet API includes an additional property, inventoryLog, to specify the custom log to use.

What do I need to do? Existing fleets must be migrated using the UpdateFleet API by July 15, 2022. After July 15, 2022 the inventoryLog property of CreateFleet API will be a required parameter. See the CreateFleet and UpdateFleet operations for details. Agents need to be on 220302.1455 or later.

MySQL Database

DB System Backup Retention Period Reduction

Service Change: The DB System backup retention period has been reduced from 10,000 to 365 days.

Date Announced: September 2020

Date in Effect: October 2020

Details:The DB System backup retention period has been reduced from 10,000 to 365 days.

Does this impact me? No.

What do I need to do? Nothing.

Network Load Balancer

Deprecated Network Load Balancer APIs

The Oracle Cloud Infrastructure's Network Load Balancer ListNetworkLoadBalancerProtocol API is deprecated as of January 12, 2022. Support for ListNetworkLoadBalancerProtocol ends on March 1, 2023. See ListenerDetails for the current list of supported protocol values.

Resource Manager

Terraform 0.11 deprecation

Service Change: Terraform 0.11 is being deprecated.

Date Announced: August 23, 2021

Date in Effect: September 1, 2021

Details: Oracle Resource Manager removes support for Terraform 0.11 on September 1, 2021.

How does this change affect my service?

When support of Terraform 0.11 is removed, your service is affected in the following ways:

  • Resource Manager does not allow creation of new stacks with Terraform 0.11.
  • Oracle does not address support tickets for stacks that use Terraform 0.11. Customers are asked to upgrade their stacks to a supported version.
Note

This change does not affect any Resource Manager stacks created with Terraform 0.12, 0.13, 0.14, or 1.0.

Are there any required actions I need to take?

If you have no need to manage the already provisioned infrastructure using Resource Manager, then no action is required.

To continue managing the provisioned infrastructure using Resource Manager, upgrade your 0.11 stacks to 0.12 or later. For instructions on upgrading stacks, see Upgrading Stacks from 0.11.x to 0.12.x.