Switch a Workspace's Environment

You may need to switch the environment your workspace uses when the old one is down, or has been decommissioned, repurposed, or replaced. By switching environments, you can resume development in the same workspace without having to push changes to the remote repository, then creating a workspace that uses the new environment.

To switch your workspace's environment, you need at least one other environment for the type of project you're working on: another Visual Builder instance or Oracle Cloud Application instance (if you use VB Studio to access the built-in catalog of Oracle SaaS/PaaS REST services or to extend Oracle Cloud Applications). If no other environments are available, ask your project owner or an administrator to create one before you try to switch environments. Then follow these steps:

Caution:

When your workspace includes business objects, switching environments may cause data loss. To avoid losing data, make sure you export the business objects before switching environments, then import them after making the switch.

1. With your workspace open in the Designer, click the Workspace menu in the header, then select Switch Environment:
   
   
   Description of the illustration switch-workspace-designer.png
   
   

   The Switch Environment dialog notifies you of the environment you're using and presents a list of other environments that are in the same identity domain as the logged-in user. (The environment currently associated with your workspace is not included.)

   Tip:

   You can also switch a workspace's environment on the Workspaces page, using the Switch Environment option in the workspace's Actions menu ().

   If multiple environments are available, select the environment you want to use. If only one environment is available, it is automatically selected for you.

2. Optional: If your selected environment contains an Oracle Cloud Application instance, select a sandbox.
3. Click Switch.