Learn about the benefits to migrating your existing Oracle Visual Builder Traditional Cloud Account instances to instances on Oracle Cloud Infrastructure, and receive an overview of the migration process and tools.
Why Migrate to Oracle Cloud Infrastructure
Oracle encourages you to migrate your existing cloud resources to Oracle Cloud Infrastructure regions. You can gain several advantages by doing so.
In Oracle Cloud, you provision resources in specific regions, which are localized to geographic locations. Certain regions support the Oracle Cloud Infrastructure platform.
Oracle Cloud Infrastructure is Oracle's modern cloud platform that's based on the latest cloud technologies and standards. It provides more consistent performance and better features at lower costs. Oracle continues to invest in Oracle Cloud Infrastructure, including the addition of new regions, services, and features. See Data Regions for Platform and Infrastructure Services.
You can benefit from these additional administrative features when you migrate your cloud resources to Oracle Cloud Infrastructure:
- Organize cloud resources into a hierarchy of logical compartments.
- Create fine-grained access policies for each compartment.
About the Migration Scope
You export the design-time metadata for each visual application into an archive file to then import into the new instance on Oracle Cloud Infrastructure.
The archive file contains the design-time metadata for the applications in your visual application, plus a variety of other files that your visual application needs once it is imported in the new instance. The following directory structure for a visual application that contains a web and mobile app, plus a business object provides an illustrative example of the type of metadata that an archive file contains.
VisualApplicationArchiveDirectory +---businessObjects | \---Department +---mobileApps | \---hrmobileapp | +---flows | | \---main | | \---pages | +---pages | | \---resources | | \---strings | | \---app | | \---nls | | \---root | ... | \---settings | \---mobile-build-templates +---process | \---pcs +---services +---settings \---webApps \---hrwebapp +---flows | \---main | \---pages +---pages | \---resources ... +---resources | +---css | \---strings | \---app | \---nls | \---root \---settings
When you export the visual application you can choose if you want the archive to include the development data contained in the application’s custom business objects. Some information, such as the user credentials to access external REST endpoints, is removed when you export a visual application. Also, mobile build configurations are not exported. A mobile configuration comprises of artifacts like keystore, iOS provisioning profiles, and passwords. Export this information and artifacts separately so that you can provide it after the archive is imported into the new instance on Oracle Cloud Infrastructure.
Apart from the design-time metadata for each visual application, you also need to export the application data for live applications. Before you migrate this data, you need to lock the live application which prevents end users from accessing the application.
About Oracle Cloud Infrastructure
Get familiar with basic Oracle Cloud Infrastructure security, network, and storage concepts before you migrate your Oracle Visual Builder instance from the traditional cloud account.
To learn more, see Key Concepts and Terminology in the Oracle Cloud Infrastructure documentation.
About the Migration Task Flow
Review the following list to understand the tasks that you need to complete to migrate Visual Builder applications from your Oracle Visual Builder Traditional Cloud Account instance to Oracle Cloud Infrastructure.
The task list assumes you have provisioned the new instance.
- Create entries for users and roles in the instance of Oracle Identity Cloud Service that the new instance of Oracle Visual Builder on Oracle Cloud
Infrastructure uses. This task is necessary as the Oracle Visual Builder Traditional Cloud Account instance used Shared Identity Management (SIM) rather than Oracle Identity Cloud Service to manage the users and roles. Notify users before you create entries in Oracle Identity Cloud Service. After you create user accounts and roles in Oracle Identity Cloud Service, each user receives a Welcome email notification with a link that allows the user to access their migrated account and set a password for it.
Users who had the
Application Builder Administrator,
Application Builder Developer, or
Application Builder Userroles in the traditional cloud account need to be assigned a
ServiceUserrole in the instance of Oracle Identity Cloud Service that the new instance of Oracle Visual Builder on Oracle Cloud Infrastructure uses.
- For each visual application (and for each version of each visual application that you wants to migrate), export the visual application from the Oracle Visual Builder Traditional Cloud Account instance.
- If you use build tools and pipelines from Oracle Developer Cloud Service, configure build jobs to point to your new instance and rebuild. Otherwise, follow the next steps to manually export and import visual applications.
- If you use Oracle Developer Cloud Service with a connection to a Git repository to manage visual applications, use Visual Builder's Import menu in the new instance to import the visual application. Each user who collaborates on a Git-managed visual application needs to perform this import. Otherwise, follow the next steps to manually export and import visual applications.
- For each application (and for each version of each visual application you want to migrate), export the visual application from the old instance.
- For each visual application, import the visual application into the Oracle Visual Builder instance.
Note:It is not possible today to import a version of a visual application; import always creates a new visual application in the Oracle Visual Builder instance.
- For each visual application, ensure proper mapping of virtual roles to Oracle Identity Cloud Service groups and app roles.
- If using team collaboration features, add team members to the newly-imported visual application as necessary.
- For each visual application, re-enter security-related details for your visual application that are not captured during export from the old instance. This includes any client IDs and basic authentication details, along with build configurations entries needed to build mobile apps.
- For each visual application, stage and publish the visual application in the Oracle Visual Builder instance.
- Test the behavior of the migrated visual application. To perform testing, you may want to export application data from the visual application on the traditional cloud account instance and import it to the new visual application on Oracle Cloud
Infrastructure. When you complete testing, perform the following post-migration steps to finish the migration of your visual applications.
If your application is embedded with an iFrame in a Fusion Application, update and test your Fusion Application to ensure your embedded application continues to function post-migration.
- For each migrated visual application, lock the visual application on the old instance.
- For each migrated visual application, use the Data Manager screen to export live data from the old instance.
- For each migrated visual application, use the Data Manager screen to import live data to your new instance.
- Inform end user clients to use the URL for the new service instance and to update any bookmarks they may have.
Note:This applies to accessing apps through a browser and client applications that may access business object REST APIs hosted in the new instance.
- Mobile apps that do not use business object REST APIs and bypass Oracle Visual Builder authentication proxy should continue working the same post-migration. Otherwise, build a new version of your mobile app on the new instance and submit it to the appropriate app store for distribution to end users.
- Migration is complete. Delete the Oracle Visual Builder Traditional Cloud Account instance.