22 Copyright © 2008, Oracle. All rights reserved. Multi-User Development

Copyright © 2008, Oracle. All rights reserved Objectives After completing this lesson, you should be able to: Set up an Oracle Business Intelligence (BI) multi-user development environment (MUDE) Describe the multi-user development environment functionality Develop a repository using multiple developers

Copyright © 2008, Oracle. All rights reserved Business Challenge By default, the Oracle BI repository development environment is not set up for multiple users. Multiple developers working in online mode lock each other out as they check out objects. This causes inefficiency and potential conflicts while other developers wait for access to the repository.

Copyright © 2008, Oracle. All rights reserved Business Solution: Oracle BI MUDE Oracle BI MUDE permits multiple users to work with the repository simultaneously: –Users edit local copies of the repository. –Changes are saved locally and then merged to the master repository. MUDE breaks the repository into manageable pieces known as projects. –Multiple users can work on the same or different projects. –Single users can improve efficiency by working on smaller subsets of the repository.

Copyright © 2008, Oracle. All rights reserved Oracle BI Repository Development Process Adheres to the classic Software Configuration Management (SCM) process: It is conceptually and functionally analogous to processes found in pure-play source control systems. Developers can check out, work on, and merge from the master code repository. Oracle BI enables and manages checkout, merging, conflict resolution, logging, code compares, version backups, and so on.

Copyright © 2008, Oracle. All rights reserved SCM Three-Way Merge Process to manage concurrent development –Highly restrictive alternative is serial development. Permits changes to the same file by multiple developers Requires merging and reconciliation: –Most merging is automatic; changes generally do not conflict. –Conflicts require manual intervention. Creates a fourth “merged” file based on two changed files, which are base-lined against a common parent file Original file Merged file File version 1 + File version 2 File version 2File version 1

Copyright © 2008, Oracle. All rights reserved Oracle BI Repository Three-Way Merge Conceptually identical to classic SCM three-way merge: Oracle BI repository is stored as a file (.rpd ). Merge is managed using the Administration Tool. Original.rpd Merged.rpd Current.rpd + Modified.rpd Modified.rpdCurrent.rpd

Copyright © 2008, Oracle. All rights reserved Multi-User Development Projects Projects: –Are subsets of repository metadata –Consist of Presentation layer catalogs and their associated business model logical facts, dimensions, groups, users, variables, and initialization blocks –Can overlap with other projects The best practice is to create projects of manageable size based on individual logical stars in the business model.

Copyright © 2008, Oracle. All rights reserved Overview: Oracle BI Multi-User Development The developer: 1.Checks out projects from the master repository 2.Makes changes in the local (current) repository 3.Merges the local changes 4.Publishes to the network Original.rpd Merged.rpd Current.rpd + Modified.rpd Modified.rpdCurrent.rpd Original Master.rpd New Master.rpd

Copyright © 2008, Oracle. All rights reserved ABC Example ABC wants multiple developers to be able to modify objects in the Inventory presentation catalog simultaneously.

Copyright © 2008, Oracle. All rights reserved Steps to Set Up an Oracle BI MUDE 1.Create projects. 2.Edit projects. 3.Set up a shared network directory. 4.Copy the master repository to the shared directory.

Copyright © 2008, Oracle. All rights reserved Create Projects Select Manage > Projects to open the Project Manager. Then select Action > New Project. Select presentation catalogs or logical fact tables in the catalogs. Selected objects are added to the project.

Copyright © 2008, Oracle. All rights reserved Edit Projects Remove unwanted fact tables from the project. Add other metadata (such as users, groups, or variables) to the project. Remove unwanted fact tables. Add other metadata to the project.

Copyright © 2008, Oracle. All rights reserved Set Up a Shared Network Directory The administrator must identify or create a shared network directory that all developers can access. All users must have access to the shared directory.

Copyright © 2008, Oracle. All rights reserved Copy the Master Repository to the Shared Directory Copy the master repository file and paste it in the directory that you have dedicated to multi-user development. Copy the master repository to the shared directory.

Copyright © 2008, Oracle. All rights reserved Making Changes in an Oracle BI MUDE 1.Point to the multi-user directory. 2.Check out projects. 3.Tasks performed by Administration Tool during checkout 4.Change metadata. 5.Multi-user options during development 6.Administration Tool tasks during check in 7.Check-in changes: Lock Information dialog box 8.Check-in changes: “Merge repositories” dialog box 9.Closing a repository before publishing to network 10.Publish to network. 11.Merge decisions. 12.Track project history.

Copyright © 2008, Oracle. All rights reserved Point to the Multi-User Directory Before checking out projects, each developer must set up the Administration Tool application to point to the multi-user development directory. Shared directory Username

Copyright © 2008, Oracle. All rights reserved Check Out Projects Select File > Multiuser > Checkout and select the desired project or projects. Select one or more projects to extract. Select master repository. Save extracted repository.

Copyright © 2008, Oracle. All rights reserved Administration Tool Tasks During Checkout Makes a temporary copy of the master repository in the local directory Saves a local copy of projects in the new repository in the local directory Saves a second local copy of projects in the new repository in the local directory with “original” as the prefix Deletes temporary copy of the master repository from the local directory Tracks transactions in a log Shared directory after extract Local directory after extract

Copyright © 2008, Oracle. All rights reserved Change Metadata Change metadata as you would during single-user development, with the following exceptions: Hierarchy definitions Project definitions Physical connection settings

Copyright © 2008, Oracle. All rights reserved Multi-User Options During Development The following multi-user options are enabled when the local, extracted repository is open: Compare with Original –Launches a dialog box that compares the local version of the original repository with the subset repository Discard Local Changes –Discards changes to local repository without checking in Merge Local Changes –Launches a dialog box to merge local changes with the master repository

Copyright © 2008, Oracle. All rights reserved Administration Tool Tasks During Checkin Locks the master repository to prevent other developers from attempting to merge at the same time Copies the master repository to the local directory to ensure that the developer merges with the most recent version

Copyright © 2008, Oracle. All rights reserved Checkin Changes: Lock Information Dialog Box Select File > Multiuser > Merge Local Changes to display the Lock Information dialog box.

Copyright © 2008, Oracle. All rights reserved Checkin Changes: “Merge repositories” Dialog Box After a developer successfully locks the master repository, the “Merge repositories” dialog box is displayed. At this point, changes are merged to the local copy of the shared repository.

Copyright © 2008, Oracle. All rights reserved Closing a Repository Before Publishing to Network If a developer attempts to close the local master repository before publishing it to the network or discarding local changes, the following dialog box is displayed:

Copyright © 2008, Oracle. All rights reserved Publish to Network Select File > Multiuser > Publish to Network. This publishes the merged repository to the network share as the new master, releases the lock on the master, and logs the event.

Copyright © 2008, Oracle. All rights reserved Merge Decisions The Regions table exists in the original and modified repositories but not in the current repository. Merge decision

Copyright © 2008, Oracle. All rights reserved Track Project History Log history is stored in a log viewer. 1. File > Multiuser > History 2. Select master repository. 3. User ID and password 4. Multi User History

Copyright © 2008, Oracle. All rights reserved History Menu Options Use menu options to navigate and view history. Details

Copyright © 2008, Oracle. All rights reserved Deleting History Items The Delete menu item is available only to Administrators defined in a hidden option file in the MUD directory. Hidden option fileStored in MUD directory

Copyright © 2008, Oracle. All rights reserved Summary In this lesson, you should have learned how to: Set up an Oracle BI multi-user development environment Describe multi-user development environment functionality Develop a repository using multiple developers

Copyright © 2008, Oracle. All rights reserved Practice 22-1 Overview: Setting Up a Multi-User Development Environment This practice covers the following topics: Creating projects Copying a master repository to a shared directory Setting a multi-user shared directory

Copyright © 2008, Oracle. All rights reserved Practice 22-2 Overview: Using a Multi-User Development Environment This practice covers the following topics: Checking out projects Modifying project metadata Checking in projects Publishing changes to the network Merging changes Checking project history

Copyright © 2008, Oracle. All rights reserved