Upgrade FAQs

Get answers to questions about the upgrade from Oracle Integration Generation 2 to Oracle Integration 3.

  1. Am I required to upgrade my instances to Oracle Integration 3?

    Yes, but only after all the features that you use, other than those that have been deprecated, are available for upgrade 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. Contact your account representative or customer success manager.

  2. 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. See Benefits of Upgrading.

  3. Are all the features from prior versions of Oracle Integration available in Oracle Integration 3?
  4. Is there a charge to upgrade?

    No. The upgrade is available at no additional cost.

  5. What is the upgrade workflow?

    See Upgrade Workflow Quick Reference.

  6. When will my instance be upgraded?

    All instances have been scheduled for upgrade. Oracle sent you an email with your upgrade date. You can also see this on the Upgrade page and in a message in the banner.

  7. Can I choose or reschedule my upgrade date?

    Yes. Oracle selects an upgrade window for you, but you can change your upgrade window if it's three 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. Contact your account representative or customer success manager. .

  8. Will there be downtime?

    Yes. Upgrades generally take less than ten minutes, but may take longer if you have a lot of files or a complex setup. 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.

  9. My upgrade was scheduled. What if I don't confirm the date or specify upgrade details?

    Your upgrade will proceed as scheduled even if you don't confirm your date.

  10. 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. However, be aware that work done in Oracle Integration Generation 2 might not be compatible with Oracle Integration 3 and vice versa based on feature differences between the versions. See the new features and differences from prior versions in What's New for Oracle Integration 3.

    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.

  11. 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.

  12. How does the upgrade affect my activity stream and actively running integrations?

    See How Upgrade Affects Runtime Data.

  13. How does the upgrade affect File Server?

    See How Upgrade Affects File Server.

  14. How does the upgrade affect Process features?
  15. 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.

  16. How does upgrade affect custom endpoints?

    If you use a custom endpoint after upgrade, you'll see no difference in runtime access to your integrations. For all other access points—design-time, Visual Builder, Process Automation—you still access the custom endpoint, but the custom endpoint then redirects to the appropriate URL.

  17. How do I know when the upgrade is finished?

    Upgrades generally take less than ten minutes, but may take longer if you have a lot of files or a complex setup. 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.

  18. Is basic authentication still supported?

    See When is Basic Authentication Supported in Oracle Integration 3?.

  19. What do I have to do before the upgrade?
  20. 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 Update Allowlists.

    After the upgrade finishes, the Oracle Integration Generation 2 IP addresses are no longer assigned to you.

    Note that the incoming IP addresses for development and production instances are different, even within the same region. However, the outgoing IP address is the same for all shapes (development or production) in a single region.

  21. 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 in the following format.

      https://design.integration.region.ocp.oraclecloud.com/?integrationInstance=query_parameter_repersenting_instance

      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.
  22. Can I switch to a different region or compartment during the upgrade?

    No. Moving regions and compartments is not part of the upgrade process.

  23. What happens during an upgrade?

    See What to Do During Upgrade.

  24. 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.

  25. 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.

  26. 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.

  27. Are Oracle Integration Generation 2 and Oracle Integration 3 integrations forward and backward compatible?

    Somewhat. Work done in Oracle Integration Generation 2 might not be compatible with Oracle Integration 3 and vice versa based on feature differences between the versions. See the new features and differences from prior versions in What's New for Oracle Integration 3.

  28. What do I have to do after the upgrade?

    See Complete Post-Upgrade Tasks.

  29. 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. See Correct an Instance with Failed Readiness Checks.

    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.

  30. 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.

  31. 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 you were using before the upgrade.

    In such situations, Oracle informs you by 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 Configure Upgrade Settings or Reschedule Upgrade.

  32. What if issues occur after the upgrade?

    After the upgrade completes, sign in and perform your typical verification tasks, and 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.

  33. 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 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.
  34. 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).

Upgrade FAQs for Process

  1. What upgrade paths are available for me if I use process?

    There are two possible paths going forward based on whether the upgrade precheck identifies active process instances in Oracle Integration Generation 2:

    • If you don't have active process instances:
      • Upgrade is handled by the Oracle Integration 3 upgrade.
      • Upgrade is automatically scheduled.
      • OCI Process Automation is provisioned and attached to Oracle Integration 3 during the upgrade.
      • Existing process applications are migrated to OCI Process Automation during the upgrade but they aren't activated and they usually need manual intervention to recover to a working state.
        Note

        If you aren't using process, no action is needed.
    • If you do have active process instances:

      You must perform a manual migration. See Migrate Actively Used Process Applications to Oracle Integration 3.

      During manual migration you'll perform following steps:

      • Set up an OCI Process Automation instance, migrate existing applications to it, and prepare it to serve new transactions.
      • Run Oracle Integration Generation 2 side-by-side with OCI Process Automation until existing transactions on Oracle Integration Generation 2 complete.
      • After all existing transactions on Oracle Integration Generation 2 have completed, your Oracle Integration Generation 2 instance will automatically be scheduled for upgrade.
  2. Why does the manual migration process recommend that the OCI Process Automation instance I create should be a standalone instance?

    A standalone OCI Process Automation instance is recommended because:

    • It ensures that there's no impact to existing integrations or Visual Builder applications.

      If you instead provisioned a new Oracle Integration 3 instance, you would also need to migrate your existing integrations and Visual Builder applications to the new environment and update your clients to the new Oracle Integration 3 URL. Additionally, you wouldn't be able to take advantage of the Oracle Integration 3 upgrade to automatically upgrade the rest of your environment.

    • It limits costs during migration.

      OCI Process Automation standalone can leverage the Oracle Cloud Free Tier pricing model. See Process Automation Pricing.

  3. I'm following the manual migration process and need help. Who can I turn to?

    You can contact your Oracle Account Representative and discuss available options if you need guidance throughout the migration process. If you've encountered a specific error or issue, create a service request (SR) on My Oracle Support.

  4. Will Oracle Integration Generation 2 process data be retained as part of the upgrade or migration process?

    No. To save or export this data prior to upgrade, complete the steps outlined in Archiving and Purging Process Automation Data in Oracle Integration.

  5. If I wait, will there eventually be an automatic upgrade for instances with actively used process applications?

    No. You should perform the manual migration to Oracle Integration 3.