Unplugging an Oracle Pluggable Database

In a multitenant BMC Database Automation (BDA) environment, you can unplug an Oracle Pluggable Database (PDB) so that you can back it up or move it to another location. Unplugging (also known as closing) a PDB makes changes in the PDB data files to record that the PDB was properly and successfully unplugged. It also generates an XML manifest file that contains information about the names and the full paths of the tablespaces, as well as data files of the unplugged PDB. This information is used when you open the PDB (known as plugging).

If a CDB already has 252 PDBs plugged into it, then unplugging one of those enables another PDB to be plugged into that CDB.

Before you begin

A container database with at least one open PDB currently managed by BDA must be available.

To unplug an Oracle Pluggable Database

1. From the Management Console, navigate to the container database that contains the pluggable database (PDB) that you want to unplug.
2. In the Pluggable Databases section of the Database Configuration page, click the PDB that you want to unplug.
3. Select Management > Unplug Pluggable Database.

4. In the General page, populate the following fields, and click Next.
5. If you select a template, click Skip Ahead to advance directly to the next step that requires input. An informational message appears on these steps, in green type, listing the fields that require entries before advancing to the next step.
    If you do not select a template, go to the next step.

6. In the Configuration page, populate the following fields, and click Next.

7. In the Custom Scripts Configuration page, select any pre-provisioning or post-provisioning scripts that you want to run as follows:

8. In the Job Options page, specify any of the following Job options, and click Next.

9. If the Change Control page displays, populate the following fields, and click Next.

   Note

   The Change Control page appears only when change control is configured for your environment. See Configuring-change-control.

10. In the Summary page, review the provisioning information.
    To make changes, do the following:
    1. Click Go to to return to the provisioning step that you want to edit.
    2. Make your changes.
    3. Click Save and Review to return to the Summary page.
11. Specify your verification preferences.
     For additional information, see Understanding pre-verification tests.
    • To continue with unplugging the database after the pre-verification tests have been successfully run without manual intervention, select Automatically Continue If All Tests Succeed.

    • To unplug the database without having first run the pre-verification steps, select Skip Pre-Verification Tests.

      Note

      The Skip Pre-Verification Tests option should only be used when you are certain all tests can succeed. The option skips verification and advances directly to the actual provisioning activity.

12. Click Unplug Oracle Pluggable Database.

13. Enter Yes when you are prompted to confirm your decision, and click OK.
    BDA prepares to unplug the pluggable database. A progress page appears.
    When the pluggable database is unplugged, it no longer appears under the CDB in the grid.

    Warning

    Once you unplug the PDB, it no longer appears in BDA (and there is no visual representation of it being unplugged) and you must recreate it to get it back.