
Author : Ana Estaki
Table of Contents
Quick Summary for Upgrade Oracle Integration GEN 2 to GEN 3
• To upgrade Oracle Integration GEN 2 to GEN 3 successfully you must resolve all precheck issues and pause development forty eight hours before your scheduled date.
• The upgrade is an automated process handled by Oracle that typically finishes in under ten minutes with minimal downtime.
• Users have until March 20 2025 to manage their transition before GEN 2 instance creation is disabled.
• Process applications require specific attention as historical instance data does not migrate automatically during the in place upgrade.
• Organizations with active production workflows should opt for migrating to a new OCI Process Automation instance to maintain business continuity.
If your organization is still Oracle Integration Cloud (OIC) GEN 2, it is time to choose your approach, prepare for upgrade, and go through it. After March 20, 2025 customers will not be able to create any more OIC GEN 2 instances.
Oracle will complete the majority of upgrade work on your behalf. All you need to do is complete some required steps and specify your requirements.
Your tasks before upgrade include:
- Correcting precheck issues: to ensure that your instance is upgrades successfully, check your upgrade readiness and correct any precheck issues:
- Configuring upgrade settings: You should have received notification of your scheduled upgrade window, checked your upgrade readiness, and corrected any precheck issues. Before your upgrade, configure the upgrade settings.
- Completing pre-upgrade tasks: If you need to reschedule your upgrade, you can do so if the upgrade is more than three business days away.
- Pausing any sort development: In the days and hours leading up to the upgrade, limiting your work in Oracle Integration Generation 2 can help ensure a successful upgrade. You’ll receive an email reminder to pause your development work two days before the upgrade.
By default, upgrade notifications are automatically sent to the specified administrator email. Oracle recommends you have notifications sent to a distribution list or group email so that you don’t miss important emails if someone leaves the company. You set who receives notifications on the Upgrade page.
Oracle responsibilities during your upgrade will include scheduling your upgrade, reminding you about the upgrade, and get it done on the date it is scheduled.
During and after upgrade:
On the day of the upgrade, before it starts, Oracle will send you an email to inform that the upgrade will start soon. The upgrade generally takes less than ten minutes. Your Oracle integration GEN 2 instance is unavailable during the downtown. After the upgrade Oracle sends an email to inform you that the upgrade completed successfully or if there was an issue. On the day of upgrade, or up to ten days after the upgrde complete post upgrade requirements. This can b done by accessing the new Oracle Integration 3 instance using your existing URL and credentials, and perform verification tasks as needed. For example, some organization perform regression testing after upgrades.
Process Upgrade Options:
Depending on how you’re using Process in Oracle Integration Generation 2, you’ll use a different option to upgrade or migrate.
Upgrade Option 1:
Automated In-Place Upgrade for Process: Upgrade option 1 applies to you if you have no process usages, or your process usage is in a pre-production state, or you are only using decision applications.
In this scenario before the upgrade you must replace the Process action in any affected integrations. And ensure that all required transactions complete in Oracle Integration GEN 2 before the upgrade.
During the upgrade, Oracle exports your process applications from Oracle Integration GEN 2, enables Process Automation in your upgraded Oracle Integration GEN 3, and converts your existing process applications and important them into your Oracle Integration GEN 3.
It is important to note that Process instance data is not migrated to Oracle Integration GEN 3. This means you wont see historical transactions created in Oracle Integration GEN 2 after the upgrade.
Once the upgrade is completed, you must perform post-upgrade activities to restore your process applications to working order.
Upgrade Option 2:
Migrate Process Application to a new OCI Process Autonomation instance: Upgrade option 2 applies to you if you are using process in production, and you have long-running process instances which cant be completed before the upgrade, and you need to continue to serve new process application requests without disruption.
Then, you need to migrate process applications to OCI Process Automation by provisioning a new OCI Process Automation instance. Migrate process applications to the new instance. Perform post-migration activities to restore process applications to working order. And update clients that call OCI Proceed automation.
Once these steps are completed, switch to OCI Process Automation for new transactions. Upgrade the Oracle Integration GEN 2 instance once all process instances complete. Attach the OCI Process Automation instance to Oracle Integration GEN 3.
Please visit Ana’s YouTube channel for OCI Videos :
www.youtube.com/@EasyOCIwithAna
People Also Asked (FAQs)
1.What is the official deadline for upgrading Oracle Integration GEN 2 to GEN 3?
Oracle has set March 20, 2025 as the final date for creating new OIC GEN 2 instances. Organizations must transition to GEN 3 before this cutoff to maintain full support and leverage the 100% cloud-native infrastructure improvements provided in the newer environment.
2.How long does the Oracle Integration GEN 3 upgrade process take?
The automated upgrade from GEN 2 to GEN 3 typically takes less than 10 minutes to complete. During this brief window, the instance remains unavailable, making it essential to schedule the 100% automated transition during low-traffic periods to minimize operational impact.
3.Will my existing process instance data be visible after the upgrade?
Historical process instance data is not migrated during the automated GEN 2 to GEN 3 upgrade. While 100% of the application metadata is transferred, active or completed transaction records will not appear in the new GEN 3 instance interface.
4.When should I stop development work before the OIC upgrade?
Development work in Oracle Integration GEN 2 must be paused exactly 48 hours before the scheduled upgrade. This freeze ensures that 100% of the metadata captured for migration is accurate and prevents synchronization errors during the final cutover phase.
5.Can I reschedule the Oracle-initiated upgrade date?
If a scheduled window conflicts with business operations, you can reschedule the upgrade as long as the request is made at least 3 business days in advance. This ensures 100% alignment with corporate maintenance schedules and resource availability.
6.What is the best upgrade approach for production Process applications?
For production environments with long-running tasks, Option 2 is required. This involves provisioning a separate OCI Process Automation instance to ensure 0% disruption for active requests while legacy tasks conclude in the GEN 2 environment before final decommissioning.
7.What tasks must be completed after the GEN 3 upgrade is finished?
Post-upgrade verification should be performed within 10 days of completion. Users must access the new GEN 3 instance using their existing credentials and run regression tests to confirm that 100% of critical integrations are functioning correctly.
8.Does Oracle send notifications before the upgrade starts?
Yes, notifications are sent to the administrator email on file. Oracle recommends using a group distribution list to ensure 100% visibility of the two-day reminder and the final ‘upgrade successful’ notification, even if individual staff members leave.
9.Are all GEN 2 integrations compatible with GEN 3?
Most GEN 2 integrations are 100% compatible with GEN 3 architecture. However, integrations using specific ‘Process’ actions must be updated manually before the upgrade to ensure the logic remains valid in the new OCI Process Automation engine.
10.How do I check if my GEN 2 instance is ready for the upgrade?
You should use the ‘Upgrade Readiness’ tool within the OIC console to identify and fix 100% of precheck issues. Resolving these issues before the scheduled date is the primary factor in ensuring a failure-free migration to GEN 3.






