RPD Merge

11/26/13 Merging and Importing Objects from Different Repositories by Using the Oracle BI 11g Administration Tool

www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/bi/bi11115/import_merge/merging_importing_11g.htm?print=preview 1/47

Merging and Importing Objects from Different Repositories by Using the OracleBI 11g Administration Tool

This tutorial contains the following sections:

Purpose

Time to Complete

Overview

Scenario

Software Requirements

Prerequisites

Examining Merge Scenarios

Merging Objects from Different Repositories with a CommonParent (Standard Three-Way Merge)

Merging Objects from Different Repositories Without aCommon Parent (Two-Way Merge)

Summary

Resources

Credits

Purpose

This tutorial illustrates how to merge and import objects from different repositories by using the Oracle Business Intelligence (BI)11g Administration Tool (Administration Tool). The three-way merge technique is examined by using two scenarios: three-way

merge with a common parent (also called the standard three-way merge) and three-way merge with no common parent(sometimes called the two-way merge).

Note: This tutorial is intended for learners who are familiar with the Administration Tool and have completed the Oracle byExample (OBE) tutorial, "Creating a Repository Using Oracle Business Intelligence Administration Tool 11g." It is alsorecommended that you complete the OBE, "Setting Up a Multiuser Development Environment by Using the Oracle BI 11gAdministration Tool" (located in the Business Intelligence section of the Oracle Learning Library) to understand how the mergeprocess occurs in a multiuser environment.

Time to Complete

Approximately 45 minutes

Overview

This tutorial provides step-by-step procedures for merging objects from different repositories by using the Administration Tool.

Scenario

In this tutorial, you initially review two different concepts for merging. You then practice these two concepts by performing astandard three-way merge and a three-way merge with no common parent.

Software Requirements

Following is a list of software requirements:

Oracle BI EE 11.1.1.5 or later must be installed along with the Sample Application schema (BISAMPLE) that is available for usewith Oracle Business Intelligence 11g. If you haven't installed the Sample Applications (825), you can install both the SampleApplication schema and repository from here.

SampleAppLite.rpd must be available on an accessible drive (local or network) as an alternate repository for merging. IfSampleAppLite.rpd is not available, you can unzip it from here and save it to\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository (for

example,c:\bi11g\instances\instance3\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository).



SampleAppLite is a lightweight version that ships with the Oracle BI EE Simple Install, while SampleApp is the full version

with many more examples and features.A text editor, such as MS Notepad or MS WordPad must be installed.

Note: Oracle BI Release 11g (11.1.1.5) automatically appends a numeric suffix to each version of the .rpd file. In this tutorial, the

repository is SampleApp_BI0009.rpd. Additionally, the SampleAppLite repository file also follows this version namingconvention (for example, SampleAppLite_BI0001.rpd).

Prerequisites

Before starting this tutorial, you should:

Have some familiarity with the Oracle BI 11g Administration ToolHave proper permissions for installing and configuring Oracle BI EE on your company's system

Note: Screen captures for this tutorial were taken in a Windows XP Professional environment; therefore, Start menu options andcolors may vary.

Examining Merge Scenarios

The Oracle BI Repository development process is conceptually identical to the classic Software Configuration Management (SCM)three-way merge, in that changes are managed by merge and reconciliation in a multiuser development environment (MUDE). The

Oracle BI Repository is stored as an .rpd file. Changes are managed by using the Administration Tool. Developers check out thefile and make changes locally. Then, these changes are reconciled and merged into the master repository. To read a moredetailed description and view an image of the merge process, click this link. Please note that this process is covered in detail inthe OBE,"Setting Up a Multiuser Development Environment by Using the Oracle BI 11g Administration Tool" (located in theBusiness Intelligence section of the Oracle Learning Library).

However, as an administrator, you may want to manually merge the changes from multiple repositories or import objects from

different repositories outside of the MUDE. Oracle BI EE offers inherent support for the classic three-way merge inside and outsidethe MUDE. The two main scenarios (outside of the MUDE) are discussed in this tutorial.

Describing Merge Types

Describing Merge Types

The two merge types discussed in this tutorial are presented below:

1 . Standard three-way merge (three-way merge with a common parent): This merge is useful when you have acommon parent repository and two derived repositories.

For example, you may have development and production repositories, both derived from a common parent

repository. You may want to import or merge the changes from the development repository into the production

repository. The three-way merge process, as indicated in the diagram to the right, depicts the Parent RPD, andtwo derived RPDsRPD A and RPD B. After the merge, a fourth merged repository file, Merged RPD, is created.

Note that modified or new objects are listed with an asterisk (*).

In RPD A, the object, Obj1, is modified, and a new object, NewObjX, is created. Similarly, a new object, NewObjB,

is created in RPD B. When these two repositories are merged, the merged repository contains obj1 (inheritedfrom the parent and modified in RPD A), and also the new objects (NewObjX and NewObjB ) from both

repositories.



2 . Three-way merge with no common parent: This is a special case formerging, where you are merging objects from two different

repositories with no common parent.

For example, as an administrator, you may want to import objects,

such as subject areas or folders, from a different repository into yourcurrent or working repository. In this particular case, the repositories

to be merged do not have a common parentthis scenario isdepicted in the diagram to the right.

Both repositories are treated differently. Conflicting object names areduplicated while merging or importing. A suffix #n is appended

(where #n is a variable number). RPD A and RPD B are treated as

separate repositories and are compared to a blank repository

(representing no common parent). The merging process will not

overwrite Obj1; instead, both copies of Obj1 (Obj1 and, Obj1#1*)from RPD A and RPD B are retained in the merged repository. Also

note that new objects from both repositories (NewObjB* andNewObjX*) are created in the merged repository.

Merging Objects from Different Repositories with a Common Parent (Standard Three-WayMerge)

In the scenario within this topic, you have a development (or current) repository in which you are working. A modified repository in

which the changes are made is also present. Both these repositories are derived from the same parent.

To compare these two repositories against the original repository and merge your changes to create a fourth merged repositoryfile, perform the following steps:

1 . Create copies with which to work. Navigate to

\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository (for example,

c:\bi11g\instances\instance3\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository)

and select the SampleApp repository (for example, SampleApp_BI0009.rpd).



2 . Right-click and from the shortcut menu, select Copy.

3 . Click Edit > Paste three times, and then rename the three copied repositories as follows: original_SampleApp_BI0009.rpd,

modified_SampleApp_BI0009.rpd, and current_SampleApp_BI0009.rpd. Your repository folder should look similar to

this:



4 . Open modified_SampleApp_BI0009.rpd in offline mode by using the Administration Tool. Click Start > All Programs > OracleBusiness Intelligence > BI Administration. The Administration Tool appears.

Note: When you first start the Administration Tool, a DOS window appears. Keep this window open while you work. You can

minimize the window to avoid accidentally closing it.



5 . Click File > Open > Offline.

6 . In the Open dialog box, select modified_SampleApp_BI0009.rpd and click Open.



7 . In the Open Offline dialog box, enter the administrator's Repository Password (this password should be Admin123) and click OK.If you are unsure of this password, you can verify it with your local administrator.

The repository opens in offline mode.

8 . Change the view within the Administration Tool to gain more space. Click View, and then deselect Business Model and MappingLayer. Similarly deselect the Physical layer. Only the Presentation layer should be visible.

Your repository should look like this:



9 . Make your changes to the modified repository. Expand A- Sample Sales and Time, select T05 Per Name Year (to change the

display name), and then right-click and select Properties from the shortcut menu.



The Presentation Column - T05 Per Name Year Properties dialog box appears.



10

.

Deselect the Use Logical Column Name check box to enable the Name text box, and delete T05 Per Name. The Properties dialog

box should look like this:



11

.

Click OK.

12

.

Similarly change T01 Per Name Week and T02 Per Name Month. The Presentation layer should look like this:



13.

Save the repository. Click File > Save and when prompted to check for consistency, click No.



Note that in this tutorial, you are simulating a modified repository scenario. You should check global consistency in your real-timeproduction environment because it validates the consistency of the metadata repository. For example, if you click Yes in the above

case, the following warnings may appear in the Consistency Check Manager.



14.

Click File > Close to close modified_SampleApp_BI0009.rpd.

15. Open current_SampleApp_BI0009.rpd in offline mode. Click the Open Offline icon ( ).

16.

In the Open dialog box, select current_SampleApp_BI0009.rpd and click Open.

17.

In the Open Offline dialog box, enter the administrator's Repository Password (Admin123) and click OK.




Review the A - Sample Sales node, specifically Time. Note that your changes are not reflected in this version of the repository.

18.

Delete the following nodes:

B - Sample QuotasC - Sample HeadcountE - Sample Essbase

F - Sample Essb Federated



H - Sample OlapM - DataminingO - Fusion Order DemoU - Usage Tracking

Ctrl-click to select multiple nodes, and then right-click and select Delete from the shortcut menu. When prompted to confirm thedeletion, click Yes.

The repository should look like this:

Note that you can still expand the node, A - Sample Sales, to view the Presentation layer tables.

19.

Now you have a current, working repository (current_SampleApp_BI0009.rpd) and a modified repository(modified_SampleApp_BI0009.rpd) that is derived from the same parent repository (original_SampleApp_BI0009.rpd).

Save the repository and do not check for consistency.

20.

The next step is to merge the changes. Select File > Merge.



21.

The Merge Repository Wizard - Select Input Files page appears. Click Select for Original Master Repository.



22.

Select original_SampleApp_BI0009.rpd.

23.

Click Open. The original repository name appears in the Original Master Repository text box.



24.

Enter the original repository password (Admin123) in the Repository Password text box.



25.

Click Select for Modified Repository.

26.

Select modified_SampleApp_BI0009.rpd and click Open.



27.

Enter the modified repository password (Admin123) in the Repository Password text box.

28.

Click Select for "Save Merged Repository as."



The "Select repository file to save the merged result" dialog box appears.

29

.

Change the default name of the merge repository. Enter merged_SampleApp_BI0009.rpd in the "File name" text box, and then

click Save.



The wizard should look like this:



30.

Click Next. The Merge Repository Wizard - Define Merge Strategy page appears. This page allows you to make informeddecisions about changed objects. You decide whether to include or exclude objects by choosing Current or Modified from the

Decision drop-down list.

31.

Select the first row (Subject Area, C - Sample Headcount). The Differences pane refreshes with conflict details. Also notice thatthe repository panes area displays the original (original_SampleApp_BI0009), modified (modified_SampleApp_BI0009),

and current (current_SampleApp_BI0009) repositories.



32

. Click the ellipsis button ( ) to the right of the Differences table to review the details of the objects that were modified.



33

.

Click Cancel.

34

.

At this point, you need to make a decision about how to proceed with the merge. In the Conflicts table at the top of the wizard, from

the Decision drop-down list for each Subject Area object, select Current for each subject area node except U - Usage Tracking.For this node, select Modified (A), indicating that you do not accept deletion of the Usage Tracking subject area.



Object relationships can be interconnected through their properties. If this is the case, By Property appears in the Decision drop-

down list. The wizard page in the image below is such an example:

To learn more about Merge Strategy, refer to Oracle Fusion Middleware Metadata Repository Builders Guide for Oracle BusinessIntelligence Enterprise Edition 11g Release 1.

35.

Click Finish. The merged_SampleApp_BI0009.rpd repository appears with your changes. Expand the A - Sample Sales subjectarea and the Time node. Review the changes to the Time node columns. The Usage Tracking subject area is still available,



because Modified (A) was chosen versus Current (where the subject area was deleted).



Merging Objects from Different Repositories Without a Common Parent (Two-Way Merge)

Although there are numerous scenarios for this technique, a simple scenario of importing new objects from two different

repositories is employed in this topic. Initially, you create a blank repository (this simulates that there isn't a parent), and then you

merge the objects from two different repositoriesSampleApp_BI0009.rpd and SampleApp Lite.rpd.

To merge these two repositories and to create a new merged repository file, perform the following steps:

1 . Create a blank repository in offline mode by using the Administration Tool. This is a one-time process.

Click Start > All Programs > Oracle Business Intelligence > BI Administration. The Administration Tool appears.



2 . Click File > New Repository.

The Create New Repository - Repository Information page appears.



3 . Enter Blank in the Name text box.

4 . Select No for the Import Metadata radio button.



5 . Enter Admin123 in the Repository Password and Retype Password text boxes, and then click Finish.



6 . The Blank.rpd repository appears.



7 . Review SampleAppLite_BI0001.rpd in offline mode. Click File > Open > Offline.

8 . In the Open dialog box, select SampleAppLite_BI0001.rpd and click Open.



9 . In the Open Offline dialog box, enter the administrator's Repository Password (Admin123) and click OK.


10.

Expand the Sample Sales Lite subject area and review the available objects.

Your repository should look like this:



11

.

Click File > Merge. The Merge Repository Wizard - Select Input Files page appears. Click Select for Original Master

Repository.



12

.

Select Blank.rpd as the original repository.

13

.

Click Open.



14.

Enter the Original Master Repository password (Admin123) in the Repository Password text box.



15

.

Click Select for Modified Repository.



16.

Select SampleApp_BI0009.rpd and click Open.



17

.

Enter the Modified Repository password (Admin123) in the Repository Password text box.

18

.

Click Select for "Save Merged Repository as."

The "Select repository file to save the merged result" dialog box appears.



19

.

Change the default name of the merge repository. Enter SampleApp_BI0009_no_CP.rpd (where no_CP indicates

that no common parent exists) in the File Name text box, and then click Save.

20 Click Next. The Merge Repository Wizard - Define Merge Strategy page appears. It should be intuitively obvious that



. you want to include the new subject areas because you are merging two totally different repositories. However, notethat there is an additional conflict for a variable, BI_EE_HOME. This variable must point to the correct "Oracle BI

Home" directory. For the example in this tutorial, the correct path is

\bifoundation\OracleBIServerComponent\coreappplication_obips1 (for example,

c:\bi11g\instances\instance3\bifoundation\OracleBIServerComponent\coreappplication_obips1).

21

.

Select the first row (Subject Area, Sample Targets Lite), and then select Current from the Decision drop-down list.



22

.

Select the second row (Subject Area, Sample Sales Lite), and then select Current from the Decision drop-down

list. The wizard page should look like this:



23

.

Select the third row (Variable, BI_EE_HOME), and then click the plus sign to expand the detail. The wizard page

should look like this:

Before you make a decision about this conflict, you should investigate further.

24

.

Double-click BI_EE_HOME in the "Modified repository" pane. The "Static Repository Variable - BI_EE_HOME" dialog

box appears. Notice that the Default Initializer location does not comply with the suggested path that is offered as anexample in the Description box. Make a note of the Description box path, so that you can compare it to the value in

the current repository.

Click Cancel.

25

.

Double-click BI_EE_HOME in the "Current repository" pane. The "Static Repository Variable - BI_EE_HOME" dialog

box appears. Notice that the Default Initializer location complies with the suggested path in the previous step.

Click Cancel.

26

.

Select the Current radio button for the BI_EE_HOME variable. The wizard page should look like this:

27

.

Click Finish. The new SampleApp_BI0009_no_CP.rpd appears with all merged nodes.

28

.

Verify that the BI_EE_HOME variable was set properly. Click Manage > Variables.

29

.

In the Variable Manager dialog box, expand Repository > Variables, select Static, and then select BI_EE_HOME in

the pane at the right.



30.

Right-click and select Properties to display the "Static Repository Variable - BI_EE_HOME" properties dialog box.The Default Initializer value points to the current Oracle BI Home.

31

.

Click Cancel to close the "Static Repository Variable - BI_EE_HOME" properties dialog box, and then click Action >

Close to close the Variable Manager dialog box.

Summary

This tutorial illustrated how to merge and import repositories by using the Oracle BI 11g Administration Tool.

In this tutorial, you should have learned how to:

Merge objects from different repositories into a common parent repository

Merge objects from different repositories and create a new repository

ResourcesOracle Business Intelligence Enterprise Edition Documentation

Oracle Business Intelligence Enterprise Edition Online TutorialsOracle University

Oracle Technology Network

Oracle Business Intelligence Discussion Forums

CreditsLead Curriculum Developer: Lea Shaw

Copyright 2011, Oracle and/or its affi l iates. All rights reserved

Date post:	06-Oct-2015
Category:	Documents
Upload:	zafar-imam-khan
View:	9 times
Download:	0 times

RPD Merge

Documents