Skip to main content
Skip table of contents

CLI cookbook: Migrating a virtual PDB in a virtual CDB

Delphix supports migrating from a vPDB in a virtual CDB, to another linked or virtual CDB. 

This topic describes how to migrate a virtual pluggable database (vPDB) in a virtual CDB to another virtual CDB using the command-line interface.

Pre-requisites

  • You should already set up and have Delphix discover a container database in the same environment as the vPDB currently is or from an environment to which the vPDB will be migrated to.

  • If the Automatic VDB Restart feature is enabled for the vPDB and the target container database is a virtual CDB, before migration, you should ensure that either the Automatic Restart feature is also enabled for the target virtual CDB or the feature is disabled for the vPDB.

Procedure

  1. Log into the Delphix command-line interface using the admin user or a user with admin privileges.

    CODE
    ssh admin@YOUR_ENGINE
  2. Disable the vPDB.

    CODE
    delphix> /source
    delphix source> select myPDB
    delphix source 'myPDB'> disable
    delphix source 'myPDB' disable *> commit
        Dispatched job JOB-35
        SOURCE_DISABLE job started for "myPDB".
        Disabling virtual database "myPDB".
        Unexporting storage containers.    Virtual database "myPDB" disabled.
        SOURCE_DISABLE job for "myPDB" completed successfully.
    delphix source 'myPDB'>
  3. Change the environment user and repository ( ORACLE_HOME ) for the vPDB to the appropriate user from the new host.

    CODE
    delphix> /sourceconfig
    delphix sourceconfig> select myPDB
    delphix sourceconfig 'myPDB'> update
    delphix sourceconfig 'myPDB' update *> set repository='/u01/app/oracle/product/19.0.0.0/dbhome_1'
    delphix sourceconfig 'myPDB' update *> set environmentUser='/oracle'
    delphix sourceconfig 'myPDB' update *> commit
        Dispatched job JOB-38
        SOURCE_CONFIG_UPDATE job started for "myPDB".
        SOURCE_CONFIG_UPDATE job for "myPDB" completed successfully.
  4. Change the environment user and repository ( ORACLE_HOME ) for the vCDB to the appropriate user from the new host. This must match the settings in step 3.

    CODE
    delphix sourceconfig 'myPDB'> /sourceconfig/
    delphix sourceconfig> select myCDB
    delphix sourceconfig 'myCDB'> update
    delphix sourceconfig 'myCDB' update *> set repository='/u01/app/oracle/product/19.0.0.0/dbhome_1'
    delphix sourceconfig 'myCDB' update *> set environmentUser='/oracle'
    delphix sourceconfig 'myCDB' update *> commit
        Dispatched job JOB-39
        SOURCE_CONFIG_UPDATE job started for "myCDB".
        SOURCE_CONFIG_UPDATE job for "myCDB" completed successfully.
  5. Enable the vPDB.

    CODE
    delphix sourceconfig 'myCDB'> /source
    delphix source> select myPDB
    delphix source 'myPDB'> enable
    delphix source 'myPDB' enable *> commit
        Dispatched job JOB-40
        SOURCE_ENABLE job started for "myPDB".
        Enabling dataset "myPDB".
        Exporting storage containers from the Delphix Engine.
        Mounting datasets.
        Mounting filesystems for the virtual database instance "1".
        Starting virtual database.
        Starting instance 1 on virtual database "myCDB".
        Virtual database "myCDB" was successfully started.
        Starting virtual database.
        Starting instance 1 on virtual database "myPDB".
        Plugging in Oracle pluggable database.
        Opening Oracle pluggable database.
        Setting OMF destination for Oracle pluggable database.
        Creating PDB tempfiles.
        Checking Oracle pluggable database plugin violations.
        Virtual database "myPDB" was successfully started.
        Dataset "myPDB" enabled.
        SOURCE_ENABLE job for "myPDB" completed successfully.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.