This topic describes how to migrate a virtual database (VDB) from one target environment to another.

In certain situations, you may want to migrate a VDB to a new target environment. For example:

  • When upgrading the host on which the VDB resides
  • During a general data center migration
  • To distribute the VDB load across target environments

This is easily accomplished by first disabling the database, then using the Migrate VDB feature to select a new target environment.



  1. Login to your Delphix Management application using Delphix Admin credentials.
  2. Click Manage.
  3. Select Datasets.
  4. Click the VDB you want to migrate.
  5. From the Actions menu (...) select Disable.
  6. Click Disable to confirm.
  7. From the Actions menu (...) select Migrate.
  8. In the Migrate window select:

    1. Environment:  the new target environment for the VDB

    2. User: select a user

    3. Installation: the Installation where you want to migrate

  9. Click Migrate to confirm your selections.

  10. From the Actions menu (...) select Enable
  11. Click Enable to confirm.

Within a few minutes, your VDB will re-start in the new environment, and you can continue to work with it as you would with any other VDB. 

Procedure via CLI

  1. Select the source associated with the VDB.

    delphix> source
    delphix source > select "vexample"
  2. Disable the source.

    delphix source "vexample"> disable
    delphix source "vexample" disable *> commit 
    delphix source "vexample"> 
  3. Select the source config associated with the source.

    delphix source "vexample"> get config
    delphix source "vexample"> /sourceconfig 
    delphix sourceconfig > select "vexample"
    delphix sourceconfig "vexample">
  4. Update the repository to the repository on the target environment for the migration.

  5. Update the environment user associated with the source config.

    delphix sourceconfig "vexample"> update
    delphix sourceconfig "vexample" update *> set repository="new target environment"/"MSSQL instance"
    delphix sourceconfig "vexample" update *> set environmentUser="new target environment"/"new target's user"
    delphix sourceconfig "vexample" update *> commit
    delphix sourceconfig "vexample">
  6. Re-enable the source.

    delphix> /source select vexample
    delphix source "vexample"> enable
    delphix source "vexample" enable *> commit 
    delphix source "vexample"> 


Related Links