Using Change Plans
Change Plans are a new feature of the Cloud Control Database Lifecycle Management Pack. Change Plans complement and extend the capabilities of existing Change Management components by allowing users to select and package metadata changes for deployment to multiple databases. Change Plans support database application development methodologies that are not adequately supported by existing Database Lifecycle Management Pack tools such as Schema Synchronizations.
Change Plans are flexible enough to support a variety of development methodologies, yet powerful enough to automate many database administration tasks previously carried out with custom scripts. These tasks include:
-
Deploying project-specific development changes from a shared development database to one or more destination databases such as integration, test, or production staging.
-
Deploying development changes from a stand-alone project development database to an integration database that collects changes from multiple development databases.
-
Upgrading common modules in development databases from a central integration database.
Change Plans are tightly integrated with the other tools in the Database Lifecycle Management Pack. Specifically:
-
Change Plan change requests that create objects can get the object definitions from Change Management Schema Baselines.
-
Change requests that modify objects can use the contents of an object in a Change Management Schema Comparison to specify the change.
-
Change Plans complement Change Management Schema Synchronizations, allowing for finer control of changes and “change-only" change requests.
About Working with Change Plans
The first phase of using a change plan to create or modify object definitions is to plan and define the changes that you want to make. For example, you may want to make one or more changes to an existing object definition in one or more databases. Or, you may want to reproduce one or more object definitions from one schema or database in another schema or database.
Figure 24-1 Steps in a Change Plan

The image shows the steps in a change plan. A change plan is a named container for change requests. You can define change requests to reproduce or modify object definitions at a destination database. A destination database is a database where you want to apply the change requests in a change plan. After you finish planning and defining the changes, evaluate the impact of the changes that you want to make.
To evaluate the impact of the change requests at a particular database, generate a script and an impact report for a change plan and that destination database. The impact report explains the changes that will be made by the script when it executes at the destination database. It also describes any change requests that cannot be applied at the destination database.
To implement the change requests in a change plan at a destination database, execute the script at the destination database.
Creating a Change Plan
This section explains the different methods of creating change plans.
You can create change plans through any of the following ways:
Creating and Applying a Change Plan From a Schema Comparison
This section explains how to create a change plan from a schema comparison.
Prerequisites for Creating a Change Plan
- Ensure that the Application Developer (AD) is an Cloud Control user who has the following privileges:
- Connect Target privilege to the development and production-staging databases targets or Connect Any Target privilege
- DBA privileges to the development database
- Create Privileges for Job System (Resource Privilege)
- Create new Named Credential (Resource Privilege)
- Edit Resource Privilege on the change plans
- Execute Command Anywhere (Target Privilege)
- EM_ALL_OPERATOR privilege
- Ensure that the Database Administrator (DBA) is an Cloud Control user who has the following privileges:
- Connect Target privilege to the development and production-staging databases targets or Connect Any Target privilege
- DBA privileges to the development database
- Create Privileges for Job System (Resource Privilege)
- Create new Named Credential (Resource Privilege)
- Manage Change Plans (Resource Privilege)
- Execute Command Anywhere (Target Privilege)
- EM_ALL_OPERATOR privilege
- It is recommended that the development and destination databases are identical at the start of the development work. For example, they may both be at the current production version, or both updated to a common interim development version.
- The Application Developer would have made changes in the development database. After creating a change plan, the application developer can create and update change items in the change plan through external clients such as SQL Developer. For more information, see Using External Clients to Create and Access Change Plans in Cloud Control.
Creating a Change Plan
Follow these steps to create a change plan:
- Log in to Cloud Control as a database administrator (DBA).
- Identify the schemas that contain application objects.
- Use Metadata Baselines wizard to define a baseline that includes the schemas of interest. Schedule a job to capture the first version of the baseline.
- Save the baseline.
- Use Schema Comparisons wizard to define a comparison between the baseline version and the development database.
- Schedule a job to create the first version of the comparison and save the comparison.
- In the Schema Change Plans page, click Create.
- Specify a Name and Description for the change plan and click OK to save the change plan.
- In the Change Items page, click Create From Comparison.
- In the Create Change Items from Schema Comparison page, select the Comparison Version created earlier, specify the development database as the Change To side and the production-staging database as the Change From side in the Conversion Assignment and click OK.
- In the Create Change Items from Schema Comparison: Select Differences page, select:
- All Differences in the Schema Comparison to add all differences in the comparison to the change plan
- Specific Differences in the Schema Comparison to select the differences in the comparison you want to add to the change plan. Select the differences.
- Submit request to apply the Change Plan on the destination database.
Applying a Change Plan
Follow these steps to apply a change plan:Using External Clients to Create and Access Change Plans in Cloud Control
Cloud Control provides support for external clients such as SQL Developer to create and access change plans. You can use these applications to connect to the Cloud Control repository and create change plans and add and update change items in them.
Client users are of two types:
-
Users who can create and access all change plans
-
Users who can access (view and possibly edit) specific change plans
Following are the steps:
-
Configure the repository database listener to allow access by a trusted client. It is recommended that you make the repository database inaccessible to login from non-trusted clients. For information about configuring the listener, see Oracle® Database Net Services Administrator's Guide 11g Release 2 (11.2).
-
Set up an Cloud Control administrator for use by an external client.
The following section describes how to set up administrators for change plans, for access from Cloud Control and from external clients.
Setting Up Cloud Control Administrator For Change Plans
Follow these steps:
-
Log in to Cloud Control as a super administrator.
-
From the Setup menu, click Security and then select Administrators.
-
In the Administrators page, click Create.
-
In the Create Administrator: Properties page, specify the Name and Password for the user. This creates a database user with the specified name and password, as well as creating the Cloud Control administrator. Click Next.
-
In the Create Administrator: Roles page, click Next.
-
In the Create Administrator: Target Privileges page, click Next.
-
In the Create Administrator: Resource Privileges page, select Change Plan Security Class and click the Manage Privilege Grants icon.
-
In the Create Administrator: Manage Privileges page, do the following:
-
If you want to create an administrator who has all access to all change plans, select Manage Change Plans in the Resource Type Privileges section.
-
If you want to create an administrator who has specific access to one or more change plans, click Add in the Resource Privileges section. In the list of change plans that have been created already, select one or more and click Select. The selected plans are added to the Resource Privileges section. By default, the administrator is granted View Change Plan privilege; you can edit this to grant Edit Change Plan privilege.
-
-
Click Continue.
-
In the Create Administrator: Review page, click Finish to create the new administrator.
-
For an external client to be able to access change plans using any of these privilege types, follow these steps:
-
Log in to the repository database as a user with DBA privileges.
-
Grant the CHANGE_PLAN_USER database role to the database user corresponding to the new administrator (through Schema->Users in Enterprise Manager Administrator, or in SQL Plus).
-