Upgrade FAQs
Get answers to questions about the upgrade from Oracle Integration Generation 2 to Oracle Integration 3.
- Am I required to upgrade my instances to Oracle Integration 3?
Yes, but only after all the capabilities that you use and that have not been deprecated are ready for upgrade in Oracle Integration 3.
You are not required to upgrade unless your Oracle Integration Generation 2 instances meet the upgrade prerequisites for capabilities that have not been deprecated in Oracle Integration 3.
Oracle selects an upgrade window for you and sends an email notification. Everyone who receives emails about Oracle Integration Generation 2 quarterly updates receives the email.
If needed, you can select a different upgrade window, but you can't opt out of the upgrade.
If you have to go live during your assigned upgrade window, Oracle can change the upgrade window to a month earlier or a month later. Enter a service request (SR) on My Oracle Support.
- What are the benefits of upgrading?
Oracle Integration 3 is the next generation of the Oracle Integration platform. The upgrade to Oracle Integration 3 delivers a modern and intuitive user interface and improved performance. Additionally, the latest features will be delivered only to Oracle Integration 3.
- Are all the features from prior versions of Oracle Integration available in Oracle Integration 3?
See Differences from Prior Versions of Oracle Integration and How Upgrade Affects Process Features.
- Is there a charge to upgrade?
No. The upgrade is available at no additional cost.
- What is the upgrade workflow?
- When will my instance be upgraded?
All instances should already be scheduled for upgrade. If you haven't received an email with your upgrade date, enter a service request (SR) on My Oracle Support.
- Can I choose or reschedule my upgrade date?
Yes. Oracle selects an upgrade window for you.
You can change your upgrade window if it's seven or more business days away.
All upgrade dates that are available to you appear on the Upgrade page, in the Upgrade Window list.
If you have to go live during your assigned upgrade window, Oracle can change the upgrade window to a month earlier or a month later. Enter a service request (SR) on My Oracle Support.
- Will there be downtime?
Yes. Your upgrade takes less than ten minutes. During this time, Oracle Integration is unavailable, and all in-flight instances stop running. See How Upgrade Affects Runtime Data.
Everyone must stop working in Oracle Integration. If you try to sign in during the downtime, a Service Unavailable page informs you that Oracle Integration is unavailable.
- My upgrade was scheduled. What if I don't confirm the date or specify upgrade details?
As long as your instances passes the upgrade check, the upgrade proceeds as scheduled.
- Can I have both Oracle Integration Generation 2 and Oracle Integration 3 instances?
Yes. For example, if you have multiple Oracle Integration Generation 2 instances, you can upgrade them at different times. Even if your instances have different versions, you can continue working in all of them.
If you are an administrator who works in the Oracle Cloud Infrastructure Console, your Oracle Integration 3 instances appear in the same list as your Oracle Integration Generation 2 instances. Each instance is clearly labeled so you can identify its version.
- Can I migrate some integrations in my instance to Oracle Integration 3 and keep some integrations in my existing Oracle Integration Generation 2 instance?
No. When you upgrade, you must upgrade the entire instance.
- How does the upgrade affect my activity stream and actively running integrations?
- How does the upgrade affect File Server?
- How does the upgrade affect Process features?
- Process functionality has undergone some important changes that you should be aware of. See How Upgrade Affects Process Features.
- After the upgrade, Process will be accessible via a new URL. See Complete Post-Upgrade Tasks for Process Automation.
- The upgrade will affect any clients (for example, integrations or Visual Builder apps) calling Process. See Complete Post-Upgrade Tasks for Process Automation.
- How does the upgrade affect Visual Builder?
Upgrade doesn't affect Visual Builder (VB); you remain on the same version of VB as you were prior to upgrade.
However, if your instance uses Visual Builder with your own Oracle database instance, a configuration which isn't currently supported in Oracle Integration 3, revert back to using the embedded database. See the note about reverting your database in Switch to a Different Oracle DB instance in Administering Oracle Visual Builder in Oracle Integration 3.
- How do I know when the upgrade is finished?
Upgrade finishes in less than ten minutes. Oracle sends you an email when the upgrade completes.
You can also see if your instance is available by trying to sign in:
- If you sign in and the user interface remains unchanged, the upgrade hasn't begun yet.
- If you sign in and a page informs you that the service is unavailable, the upgrade is still in progress.
- If you sign in and the user interface has changed, the upgrade is finished.
Confirm the upgrade finished by checking the version number in the About dialog.
- Is basic authentication still supported?
See When is Basic Authentication Supported in Oracle Integration 3?.
- What do I have to do before the upgrade?
- Complete the upgrade prerequisites.
- Configure your upgrade settings.
- As your upgrade date approaches, update your allowlists and perform some additional pre-upgrade tasks.
- Will the IP address of my instance change?
Yes. After the upgrade, the Oracle Integration 3 instance has a different IP address than the Oracle Integration Generation 2 instance.
If you have allowlists, you need to allowlist the new IP addresses. See 3. Update Allowlists and Complete Pre-Upgrade Tasks.
After the upgrade finishes, the Oracle Integration Generation 2 IP addresses are no longer assigned to you.
Note that the ingress IP addresses for development and production instances are different, even within the same region. However, the egress IP address is the same for all shapes (development or production) in a single region.
- Will my URLs change?
- The runtime URL for Oracle Integration 3 won't change; it will be your Oracle Integration Generation 2 URL.
- The design-time URL will change, but your bookmarks will still work. The design-time URL for Oracle Integration 3 is a combination of your Oracle Integration 3 base URL, your instance name, and your region.
After the upgrade, the design-time URL for your Oracle Integration Generation 2 instance redirects to the new Oracle Integration 3 instance URL, so you can continue using your existing bookmark or update it. It's up to you.
- The Process URL will change.
- Can I switch to a different region or compartment during the upgrade?
No. Moving regions and compartments is not part of the upgrade process.
- What happens during an upgrade?
- What if a scheduled integration is running when the upgrade begins?
Prior to the upgrade, Oracle stops the schedule if it's running. After the upgrade, the schedule starts in Oracle Integration 3 from the point where it stopped in Oracle Integration Generation 2.
- Should I stop my scheduled integrations before the upgrade?
Oracle doesn't recommend stopping your scheduled integrations. If you stop your integrations in your Oracle Integration Generation 2 instance, the integrations remain stopped in the Oracle Integration 3 instance after the upgrade is complete, and you'll have to manually restart everything.
- Will my Oracle Integration Generation 2 instance still be available after the upgrade?
No. Your Oracle Integration Generation 2 isn't available after the upgrade.
- Are Oracle Integration Generation 2 and Oracle Integration 3 integrations forward and backward compatible?
No. Oracle Integration 3 includes many new features that aren't available in Oracle Integration Generation 2, making integrations incompatible between the two versions.
- What do I have to do after the upgrade?
- What if something changes after my upgrade is scheduled and my instance can't be upgraded anymore?
After scheduling the upgrade, Oracle checks your instance often to make sure it's still ready. If the check identifies any issues, Oracle emails you so you can address the issues and proceed with the scheduled upgrade.
Oracle also checks your instance at the beginning of the upgrade window. If the check identifies any issues, Oracle cancels the upgrade and emails you about the change. Everyone who gets emails about Oracle Integration Generation 2 quarterly updates receives the email, which includes information about next steps.
- Will my user, group, and policy information be available after upgrade?
Yes. All security-related information from your Oracle Integration Generation 2 instance is present in your Oracle Integration 3 instance after the upgrade. Additionally, the upgrade doesn't change anything related to identity domains. For example, if your tenancy uses identity domains before the upgrade, it continues using identity domains after the upgrade.
- What if issues occur during the upgrade?
In rare situations, an issue prevents an upgrade from completing. When an upgrade doesn't complete, Oracle rolls back the changes, turns on the schedule in the Oracle Integration Generation 2 instance, and restores your access to the instance during the downtime period. You continue working in the Oracle Integration Generation 2 instance, with the same features and capabilities you were using before the upgrade.
In such situations, Oracle informs you over email that you can continue working in Oracle Integration Generation 2. Expect the email to arrive either within your upgrade window or soon after. Everyone who gets emails about Oracle Integration Generation 2 quarterly updates receives the email. You can schedule your upgrade for another time, and Oracle works with you to determine the next steps.
When you specify upgrade requirements, you can also choose to ignore specific issues during upgrade. For instance, you determine whether to proceed with the upgrade if Oracle is unable to activate all integrations and start the schedule for all integrations. See 2. Schedule the Upgrade and Configure Settings.
- What if issues occur after the upgrade?
After the upgrade completes, sign in and perform your typical verification tasks. Additionally, complete the required post-upgrade tasks.
If you experience any issues after the upgrade, either while performing verification tasks or performing day-to-day activities, enter a service request (SR) on My Oracle Support.
- If I use the connectivity agent, do I need to recreate any connections?
No. However, you should be aware of several points:
- Before upgrade, you must update your allowlist settings to configure connectivity from your connectivity agents to Oracle Identity Cloud Service (IDCS) and the Oracle Integration runtime URL and IP addresses.
- During the upgrade, the connectivity agent is automatically converted from using basic authentication to using OAuth 2.0 token-based authentication to communicate with Oracle Integration. All agents are automatically upgraded to OAuth 2.0, so you don't need to manually recreate any agents yourself.
- After the upgrade, you’ll see additional traffic to your firewall because the connectivity agent must get new authentication tokens from the Oracle Identity Cloud Service or the identity domain.
- Agents that are offline during upgrade or don't meet upgrade requirements won't be upgraded. You'll need to perform post-upgrade steps to regain connectivity.
- If I convert the JKS KeyStore to the PKCS12 KeyStore for the connectivity agent, does this affect my Oracle Integration Generation 2 connectivity agent?
No. Converting the JKS KeyStore to the PKCS12 KeyStore does not impact your Oracle Integration Generation 2 connectivity agent, and only takes effect after you have upgraded to Oracle Integration 3. You can convert your keystore manually or let it happen automatically during upgrade (requires agent to use JDK 17).