Upgrading Oracle Business Intelligence from 10g to 11g
This tutorial covers using Oracle Fusion Middleware Upgrade Assistant to upgrade an existing Oracle Business Intelligence 10g environment to an 11genvironment.
Time to Complete
Approximately 1 hour.
This tutorial provides step-by-step procedures for using Oracle Fusion Middleware Upgrade Assistant to upgrade an existing Oracle Business Intelligence (BI) Enterprise Edition 10g Release 3 (10.1.3.2 or later) environment to Oracle Business Intelligence Enterprise Edition 11g in a Windows environment on a single machine. You learn how to upgrade the OBI repository and presentation catalog, as well as the Oracle BI Publisher (BI Publisher) repository. This tutorial uses the 10g version of the Sample Sales application to demonstrate the upgrade process, and also covers a subset of 11g features and functions that you should consider applying as part of a post-upgrade configuration.
Before starting this tutorial, you should:
Have access to or have installed Oracle Business Intelligence Enterprise Edition 11g Have access to the Sample Sales repository and Web catalog metadata, designed for Oracle Business Intelligence Enterprise Edition 10g. You can download this sample data set from here or from the Oracle Technology Network (OTN). This tutorial shows you how to upgrade this sample data set from 10g to 11g. Have downloaded the BIP10gRepository.zip file to your local hard drive, unzipped, and copied the files to your local hard drive. In this example, the files are extracted to D:\Repository.
Installing the Sample Sales Data Set
In this set of steps, you download and unzip the Sample Sales data set on the server on which Oracle Business Intelligence Enterprise Edition 11g is installed. To install the Sample Sales data set, perform the following steps:
1. As described in the Prerequisites section, download the 10g Sample Sales data set files (oracle_bi_sample_analysis_setup_files.zip) from here or from the Oracle Technology Network (OTN) to a directory on a server on which Oracle BI 11g is installed. In this example, the zip file is downloaded toD:\SampleSales.
2. Unzip the Sample Sales data set. You should see four new files: Sample_Sales_V1.3_Dataset.zip Sample_Sales_V1.3_Readme.txt Sample_Sales_V1.3_Webcat.zip samplesales.rpd
3. Extract Sample_Sales_V1.3 Webcat.zip to a subfolder in D:\SampleSales. In this example, the zip file is extracted to D:\SampleSales\Sample_Sales_V1.3_Webcat\samplesales. This folder now contains the Sample Sales 10g presentation catalog.
4. Create a new directory named deliveries in D:\SampleSales\Sample_Sales_V1.3_Webcat. In 10g, the deliveries directory is a special directory used for data such as Dashboard snapshots used by Briefing Books. The directory is called deliveries by default and is located in the OracleBIData\web\catalog directory. In many cases, the 10g directory is empty. If the 10g deliveries directory is not available, any empty directory named deliveries can be given for upgrade. If Upgrade Assistant finds a directory called deliveries in the same folder as the catalog, it is selected by default.
5. Sample_Sales_V1.3_Dataset.zip contains a sample set of data in XML format for display in Oracle BI dashboards. To make this data available for queries, extract Sample_Sales_V1.3_Dataset.zip to the following location:
%MIDDLEWARE_HOME%\instances\instance1\bifoundation\OracleBIServerComponent coreapplication_obis1\server\Sample The extraction will create a new directory named samplesales with a set of XML files. Please notice that you must create the two directories server\Sample to maintain the relative paths for all of the XML files in the repository. In this example, the data set is extracted to: D:\bi\instances\instance\bifoundation\OracleBIServerComponent\ coreapplication_obis\server\Sample\samplesales
samplesales. Upgrading the Oracle BI Repository and Catalog
To upgrade the Sample Sales repository and presentation catalog.
You are now ready to begin the upgrade process for the Sample Sales data set. the directory path is D:\bi\Oracle_BI1\bin. In this example.6.rpd is the Sample Sales 10g BI repository. perform the following steps by using the Upgrade Assistant. Please note that the WebLogic Administration Server and the Managed Server in the 11g environment must remain running during the upgrade process. You can leave this file in D:\SampleSales.
. Navigate to the ORACLE_HOME\bin directory of the Oracle Fusion Middleware installation.
2. see "Using the Upgrade Assistant Command-Line Interface" in Oracle Fusion Middleware Upgrade Planning Guide. For more information. You can also use the Upgrade Assistant command line to perform these tasks. click Next.
3. Double-click ua.bat to open Upgrade Assistant in the graphical user interface mode. This tutorial describes how to use Upgrade Assistant in the graphical user interface mode. On the Welcome screen.
. select Upgrade Oracle BI RPD and Presentation Catalog and click Next.4. On the Specify Operation screen.
On the Specify Source Details screen.
.5. select Upgrade Repository (RPD).
Click Browse next to the RPD File field. the path isD:\SampleSales\samplesales. In this example. Browse to the location of the 10g version of the Sample Sales repository and click Open.6.
. The path to samplesales.rpd is added to the RPD File field.8.
Enter the Administrator User Name and Administrator Password for the 10g samplesales repository. the username and password are both Administrator.9.
. In this example.
10. Enter and confirm a password that will be used to secure the upgraded 11g repository.
. This password is required for 11g repositories. the password is welcome1. In this example. It does not have to match the 10g repository password or any other password.
.11. Select Upgrade Catalog.
3_Webcat\samplesales. Click Browse next to the Catalog Directory field. In this example the path is D:\SampleSales\Sample_Sales_V1.
. Browse to the location of the 10g version of the Sample Sales presentation catalog and click Open.
.14. The path to the Sample Sales presentation catalog is added to the Catalog Directory field. The path to the deliveriesdirectory is automatically added to the Catalog Deliveries Directory field.
. enter the WebLogic Admin Server port number. On the Specify WebLogic Server screen. Typically the port number is 7001. Click Next to continue.
In this example. Enter the username and password for the WebLogic Admin Server.
. it is weblogic/welcome1.17.
Click Next to continue. wait until you see a succeeded message. the source directory is readable.
. During the examination process.
19. and contains a file for upgrade. Upgrade Assistant checks whether the source directory exists. On the Examining Components screen.18.
On the Upgrade Summary screen. BI components are stopped and restarted.
21. The Sample Sales presentation catalog and repository are loaded.
22. you can view the upgrade progress. review the summary of the upgrade to be performed. Click Upgrade to start the upgrade process. On the Upgrading Components screen.
. Click Next to continue.20.
When the upgrade completes the status changes to succeeded. inspect the log files for details. You can also check the component log files in directories organized by component under <ORACLE_INSTANTANCE>\diagnostics\logs.log where<timestamp> is the current date and time.
. The log files are located in <BI_ORACLE_HOME>\upgrade\logs\ua<timestamp>.24. If there are errors during the upgrade.
.25. Click Next to continue. review information related to the upgrade task and click Close. On the Upgrade Success screen.
. You can verify that Oracle BI EE has been upgraded successfully by logging into the 11g system to confirm that Oracle BI EE components are running. In a browser.
3. and verifying that you are able to view dashboards and reports.
2. In the left pane. To verify the upgrade. checking repository metadata. perform the following steps:
Verifying Oracle BI system components Verifying repository metadata Verifying reports and dashboards
Verifying Oracle BI System Components
1. expand Business Intelligence > coreapplication. select the Overview page and confirm that all system components are available.Verifying the Upgrade
The Upgrade Assistant automatically loads the new repository to the 11g BI Server and restarts all BI components. enter http://localhost:7001/em to log into Fusion Middleware Control on the 11g system. In the right pane.
Select the Repository subtab. The username and password are the Oracle WebLogic Server adminis username and password created during your 11g installation.
5. the repository is named assamplesales_BI0002.
Verifying Repository Metadata
1. This page shows the current installed repository. the user is weblogic. Select the Deployment page. Select Start > Programs > Oracle Business Intelligence > BI Administration to open the Administration T
2. The repository password is the password that you identif during the upgrade process: welcome1.4. In this example. Select File > Open > Online to open the repository in online mode. In this example. Enter the repository password and user password. Notice that the Upgrade Assistance automatically uploaded the upgraded repository to the BI Server domain.
Click Open to open the upgraded repository in online mode.
.4.Sample Sales (XML). In the Physical layer.
5. expand A .
6. Click Yes to check out the object.
. Double-click Connection Pool A.
9. Select Manage > Variables to open Variable Manager. In the steps that follow. This points to the location wher XML files are stored. you modi theBI_EE_HOME variable to point to the correct directory. The data source name includes a variable (BI_EE_HOME) and the path to the directory are stored.\server\Sample\samplesales directory on the 11g server.8... Notice the data source name field.
. The Connection Pool A dialog box opens. Recall that earlier in this tutorial you unzipped the Sample Sales XML data files to the. Click OK to close the Connection Pool dialog box.
11. In the right pane, double-click the BI_EE_HOME variable.
12. Click Yes to check out the object.
13. In the Static Repository Variable dialog box, change the Default Initializer to the XML data source path (with additional directories). In the example shown below, you set the variable initializer to
14. Click OK to close the Static Repository Variable dialog box.
15. Select Action > Close to close Variable Manager.
16. Check in the changes.
17. Save the repository. (There is no need to check consistency at this point.)
18. Close the repository.
19. Click OK when you receive the message about manually restarting each non-master Oracle BI Server instanc
20. Close the Administration Tool.
Verifying Reports and Dashboards
1. Sign in to Oracle BI 11g as an administrative user. In this example the user is weblogic. Your username and password will vary depending on how you have installed and configured your environment.
2. Click the Administration link.
Click the Home link. in the Maintenance and Troubleshooting section. Create and run an analysis to test your metadata and data.3. click Reload Files and Metadata.
4. On the Administration page. From the Home page. select Analysis > Samples Sales to open the Analysis Editor.
8. Congratulations! You have upgraded the Sample Sales data set from 10g to 11g and verified that the upgraded Oracle BI system components. repository. Open and view dashboards.
. and presentation catalog are working as expected. Sign out of Oracle BI.
Incorporating Changes to 11g Repository Metadata
After upgrade. it is likely that you will see error and warning messages that you did not see in 10g. there are a number of differences between the 10g and 11g environments related to Oracle BI repository metadata.
The steps that follow provide only a few examples of 11g consistency check errors and warnings that should be addressed. in 10g. After upgrading from a previous software version and checking the consistency of your repository. or inconsistencies at multi-user development (MUD) checkout time. This typically indicates inconsistencies that had been undetected before the upgrade. some rules that existed in previous releases might now be displayed during consistency checks. Consistency Check Manager opens. Select File > Open > Online to open the repository in online mode. This tutorial covers only a small subset of the differences you should address post-upgrade. Specifically. the Consistency Check Manager now enforces additional validation rules to help ensure that your repository is consistent.
4. please refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g and Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence 11g. As a result.
5. In addition. some rules that existed in previous releases might now be displayed during consistency checks. Select File > Check Global Consistency. not new errors. this topic discusses:
Incorporating enhanced repository consistency checking Incorporating repository modeling changes Incorporating changes to the repository security model
For additional information about repository metadata upgrade considerations. there were several modeling constructs allowed by the consistency checker that resulted in unexpected query behavior at runtime. the Consistency Check Manager addresses these issues by enforcing additional validation rules to help ensure that the repository is consistent. In addition.
For example. Enter the repository password (welcome1) and user password. Select Start > Programs > Oracle Business Intelligence > BI Administration to open the Administration Tool.
2. you might notice messages that you had not received in previous consistency checks.
Incorporating Enhanced Repository Consistency Checking
In 11g. refer to Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence 11g and Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence 11g. In 11g. Notice that there are consistency check errors and warnings. For more information. Click Open to open the upgraded repository in online mode.
the aggregation content of the extracted logical table source would not be the same as in the original logical table source. Warning 39051 indicates that there is a BI Administrators application role that is defined in the repository. but not defined in Fusion Middleware Control Enterprise Manager.Error 38123 indicates that the initialization block test1 is not associated with the system variable USER. Warning 39054 indicates that the aggregation content filter "Group by Level" in the logical table source of a fact table references logical dimension tables that are not joined to that fact table.
8. select Manage > Variables to open Variable Manager.
. If that fact table is extracted in the extract/MUD process. Minimize Consistency Check Manager. You learn more about addressing this warning in the subtopic on 11g security.
7. In this case. To address error 38123. the dimensions that are not joined will not be extracted.
10. In the right pane right-click the test1 initialization block and select Delete. In the left pane. select Session > Initialization Blocks.9.
11. Click Check Out.
Select Action > Close to close Variable Manager. Click Check All Objects.
16. Restore Consistency Check Manager. Confirm that error 38123 no longer appears in Consistency Check Manager.12.
13. Click Yes to confirm the delete.
you address the consistency check warning 39054 related to logical joins.
In the steps for this topic. In previous releases.
For more information related to using the Physical and Business Model layer diagrams. including an improved look-and-feel.
There are a few additional changes you should be aware of:
Joins in the Physical and Business Model Diagrams are represented by a line with an arrow at the "one" end of the join. use Ctrl + click to select the following tables in the Business Model and Mapping layer: D1 Customer D3 Order D5 Employee
. To address warning 39054. In the process. joins in the diagrams were created by selecting the "one" end of the join first.
1. When creating joins in the Physical and Business Model Diagrams. you now select the "many" end of the join first. you explore some of the 11g changes to the modeling diagrams. please refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g and Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence 11g.17. the ability to display columns in table objects in the diagram. and new diagram options like auto-layout. marquee zoom.
Incorporating Repository Modeling Changes
The Physical and Business Model Diagrams have enhanced capabilities in the 11g release. rather than the line with crow’s feet at the "many" end of the join that was used in previous releases. and zoom to fit. and then select the "one" end of the join.
18. Minimize Consistency Check Manager. Leave the repository open in online mode for the next subtopic.
F1 Inv Base Measures
2. Right-click any one of the four highlighted tables and select Business Model Diagram > Selected Tables Only to open the Business Model Diagram.
. click the Fit icon or use the Zoom icons to adjust the diagram so that all four objects are visible. In the diagram toolbar.3.
select the New Join button on the toolbar. and then select the "one" end of the join. To create logical joins.
5. when creating joins in the Physical and Business Model Diagrams. joins in the diagrams were created by selecting the "one" end of the join first.4. Again. Click OK to close the Logical Join dialog box. In previous releases. you now select the "many" end of the join first. Click the F1 Inv Base Measures table first and then click the D5 Employee table to open the Logical Join dialog box.
7. The logical join is created between F1 Inv Base Measures and D5 Employee.
9. and F1 Inv Base Measures andD3 Order.
8. Click Check Out. Repeat the steps to create joins between F1 Inv Base Measures and D1 Customer.
Restore Consistency Check Manager.
12. Close the Business Model Diagram.
Incorporating Changes to the Repository Security Model
14. Verify that the 39054 warnings are no longer visible. Click Check All Objects.
11. Leave the repository open in online mode for the next subtopic. Minimize Consistency Check Manager.
This tutorial covers only a small subset of the changes related to security in Oracle BI 11g.
. the identity used to establish trust between processes in an installation is configurable and independent. select the Users tab. In the right pane.
In Oracle Business Intelligence Release 10g. In Oracle Business Intelligence Release 11g. In Oracle Business Intelligence Release 11g. For more information related to security. users and groups could be defined within a repository file by using the Oracle BI Administration Tool.
In the steps for this topic you address the consistency check warning 39051 related to application roles. Instead. Notice the Administrator user.
1. but these objects are pointers (references) to the externally managed roles. you explore some of the 11gchanges to the Oracle BI repository security model. The repository password is stored in an external credential store when you publish a repository in Fusion Middleware Control. but these objects are pointers (references) to the externally managed users. a special user named Administrator has full administrative permissions and is also used to establish trust between processes within that installation. User objects exist in the repository. In the left pane.
Groups no longer exist in the repository as objects. In Oracle Business Intelligence Release 11g. expand Identify Manager and select BI Repository. Application role objects exist in the repository.
3.so that the Oracle BI Server can retrieve the password to load the repository. you implement data access security based on the application roles to which a user belongs. there is no special significance to the name Administrator and there can be one or more users who are authorized to undertake different sets of administrative functions. select Manage > Identity to open Identity Manager.
Users are managed in an external identity store and are no longer managed in the repository. The Oracle Business Intelligence Enterprise Edition Upgrade Assistant migrates users and groups from a Release 10g repository into the embedded LDAP server in a Release 11g installation.There are changes in the Oracle BI 11g repository related to security:
As discussed earlier in this tutorial. In an Oracle Business Intelligence Release 10g installation. Application roles are managed in an external policy store. please refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g and Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition. repositories now have repository-specific passwords that are used to encrypt the repository contents. users and groups can no longer be defined within a repository. To address warning 39051. In the process.
. You explore this security realm in more detail later in this tutorial.
8. Enter an asterisk (*) in the field and click OK. Notice that the Users tab is now populated with all of the users defined in the WebLogic security realm. including theweblogic administrative user. Notice the demo2 and demo users.
7. For example. Your results will vary depending on which users you have defined in your 11genvironment. the users Administrator_f and Administrator_d are unique to the environment used to build this tutorial. These are additional users from the 10g Sample Sales repository. Select Action > Set Online User Filter.5.
In Oracle Business Intelligence 11g. These are security groups that were defined in the 10g Sample Sales repository.
In Oracle Business Intelligence 10g. test. This indirection allows an Oracle Business Intelligence 11g system to be deployed without changes to the corporate directory and eases movement of artifacts between development.
.9. They are automatically converted to application roles in the 11g environment. which are in turn are assigned to users and groups in a directory.
10. security policies in the Oracle BI Presentation Catalog and repository could be defined to reference groups within a directory. Click the Application Roles tab. Notice the application roles beginning with XMLP. and production environments. a level of indirection is introduced whereby security policies are defined in terms of application roles.
Restore Consistency Check Manager. which is why you received the consistency check warning39051. is not a default application role. right-click BIAdministrators and select Delete.11. Select Action > Close to close Identity Manager.
15. Notice also the following application roles: BIConsumer BIAuthor BIAdministrator Oracle BI 11g provides this set of application roles as part of the default security realm.
. To remove the warning. however.
12. Click Yes to confirm the delete. Click Check Out. Click Check All Objects.
18. Verify that the 39051 warning is no longer visible.
19. Close Consistency Check Manager.
20. Check in the changes.
21. Click Yes to check global consistency.
22. You should receive a message that consistency check did not find any errors, warnings, or best practice violations.
23. Click OK.
24. Save the repository.
25. Select File > Copy As and save a copy of the repository with the file name samplesales.rpd. You will use this copy later in this tutorial.
26. Close the repository.
27. Click OK.
28. Leave the Administration Tool open .
Exploring Default Security Settings for Oracle BI 11g
There are changes to how security is managed in Oracle BI 11g. Security is now managed by using WebLogic Administration Console and Fusion Middleware Control.
During installation, three Oracle Business Intelligence security controls are preconfigured with initial values to form the default security model. The security controls include:
An embedded directory server functioning as an identity store designed to hold all user and group definitions, required to control authentication A file-based policy store designed to hold the application role and permission grant mappings to users and groups, required to control authorization A file-based credential store designed to hold all user and system credentials, required to control authentication or authorization
In the steps for this topic, you explore some of these default security settings.
This tutorial explores only a small subset of the security model changes for Oracle BI 11g. For more information related to upgrade considerations for security, please refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g and Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition.
1. To open the WebLogic Administration Console, open a browser, enter the following URL:http://localhost:7001/console and sign in as an administrative user.
This console is used to manage users and groups for the embedded LDAP server that serves as an out-of-the-box identity store. During installation, you are prompted for a username and password to use as an Oracle BI Administrator. In this training environment, the Administrator user created during installation is weblogic. This is an arbitrary choice and there is nothing special about the name. This user has administrative privileges across the Oracle Business Intelligence 11g stack. This includes the OBI repository, the OBI presentation catalog, OBI Publisher, RTD, Essbase, the identity store in WebLogic, and the Policy Store in Fusion Middleware.
2. On the left side of the console, under Domain Structure, notice that there is a single WebLogic domain namedbifoundation_domain into which all the OBI applications are deployed.
Click Security Realms.
4. Notice in the right pane that there is a single default security realm named myrealm.
security policies. groups. security roles.
5. Although multiple security realms can be defined for the OBI domain. Click the Providers tab. Notice that there is a default WebLogic Authentication Provider. A security realm is a container for the mechanisms that are used to protect WebLogic resources. and security providers.
7. Click myrealm to view the default security settings.
6. at any given time.The OBI installer installs a single domain with a single security realm in it.
. This includes users. only one can be active. meaning designated as the default realm.
Click the Users subtab.An authentication provider establishes the identity of users and system processes. Click the Users and Groups tab. and serves as a repository for identity information from which components can retrieve it. transmits identity information. but the WebLogic authentication provider is used by default.
. Oracle Business Intelligence is configured to use the directory server embedded in Oracle WebLogic Server as the default security provider.
9. Alternate security providers can be used if desired and managed in the Oracle WebLogic Administration Console.
and an administrative user created during Oracle BI installation ("weblogic" in this example). an administrative user is a member of the BIAdministrators group and has all rights granted to the Oracle Business Intelligence Administrator user in earlier releases. this username is created during installation. An administrative user is also a member of the Oracle WebLogic Server default
. with the exception of impersonation. OracleSystemUser. Some of these other users are from the 10g repository and were created by the Upgrade Assistant (for example. Notice that the other users here match the users you saw in the repository after running Set Online User Filter.
10. This is the administrative user created during the installation process. The three default users are BISystemUser. A single administrative user is shared by Oracle Business Intelligence and Oracle WebLogic Server. and some are from the 11g environment used to build this tutorial (for example.The default identity store is pre-seeded with usernames specific to Oracle Business Intelligence. As stated earlier. These default usernames are provided as a convenience so that you can begin using the Oracle Business Intelligence software immediately after installation but you are not required to maintain the default names in your deployment. demo and demo2). and therefore does not need to be ―Administrator.‖ The password is likewise provided during installation. Administrator_f and Administrator_d). In the default security configuration. Notice the weblogic user. An administrative user cannot impersonate other users. can be any desired name.
Click the Groups subtab. groups are then mapped to application roles in order to grant rights. The name of this user is the default. Creating groups of users who have similar system resource access needs enables easier security management. such as BISystemUser. including the ability to manage Oracle WebLogic Server’s embedded directory server and policy store. Managing a group is more efficient than managing a large number of users individually. As you will see later in this practice.
12. Oracle recommends that you organize your users into groups for easier maintenance. Notice the BISystemUser user. to secure communication between Oracle BI components enables you to change the password of your deployment’s system administrator account without affecting communication between these components. and it can be changed or a different user can be created for the purpose of inter-process communication.
. Using a trusted system account.
Groups are logical ordered sets of users. the latter being the practice in earlier releases. This is a highly privileged user whose credentials should be protected from non-administrative users. Oracle Business Intelligence system components establish a connection to each other as BISystemUser instead of as the Administrator user. which enables this user to perform all its administration tasks.Administrators group.
Members of the BIAdministrators group are by default members of both other groups. Groups are nested in a hierarchy. Members of the BIAdministrators group have permissions equivalent to those of the Administrator user of earlier releases.13. Notice the three default groups specific to Oracle BI: BIAdministrators. Notice that the weblogic user is a member of the two administrator groups: Administrators and BIAdministrators. Membership in
. Members of the BIConsumers group have the permissions necessary to consume content created by others. Members of the BIAuthors group have the permissions necessary to create content for others to consume.Administrators is the WebLogic administrators group. and BIConsumers.
14. but you are not required to maintain the default names in your deployment. Members of BIAuthors are members of BIConsumers. These default groups are provided as a convenience so you can begin using the Oracle Business Intelligence software immediately after installation. which gives rights to administer WebLogic and FMW enterprise manager. BIAuthors. Select Users > weblogic > Groups.
17. expand Business Intelligence.
16. By default. the obi application stripe is selected and the default application roles are displayed.
18. Right-click coreapplication and select Security > Application Roles to navigate to the Application Roles page. If it is not open. Return to the browser tab where Fusion Middleware Control is open. In the left pane. enter http://localhost:7001/emand log in as an administrative user. The groups inherited from the 10g Sample Sales repository (XMLP_*) are also displayed as
.both administration groups gives this user a single unified administration account for the entire product stack.
whereas groups are in the identity store. If you moved to a different LDAP server.application roles. rather than the default WebLogic LDAP server. Application roles are in the policy store. The default application roles are:
BIAdministrator: Grants administrative permissions necessary to configure and manage the Oracle Business Intelligence installation. The groups are listed in the Members column. This role is required by Oracle Business Intelligence system components for inter-component communication. Any member of the BIAuthor group is explicitly granted this role. Any member of the BIAuthor group is explicitly granted this role and implicitly granted the BIConsumer role. BIAuthor: Grants permissions necessary to create and edit content for others to consume.
. BISystem: Grants the permissions necessary to impersonate other users.
20. The default application roles are mapped to default groups in the default WebLogic LDAP. Any member of the BIAdministrator group is explicitly granted this role and implicitly granted the BIAuthor and BIConsumer roles. you could map these roles to groups in the new LDAP server. BIConsumer: Grants permissions necessary to consume content created by others.
. the obi application stripe is selected and the default application policies are displayed. In the left pane. By default.
The default file-based policy store is pre-seeded with the Oracle BI-specific permissions. right-click coreapplication and select Security > Application Policies.
Leave Fusion Middleware Control open.
3. Recall that this is the copy of the upgraded repository you created earlier in this tutorial. This topic covers only one new feature: defining presentation hierarchies and presentation levels in the Presentation layer. Instead. For more information. or launch the Administration Tool from the command line by using bi-init. reports. H2 Market. The resulting Administration Tool window is not initialized to your Oracle instance.cmd. and errors will result later in your session.Oracle Business Intelligence permissions are provided and you cannot create additional permissions.rpd in offline mode. for example.
Applying New 11g Repository Metadata Features
There are new repository metadata features for 11g that you should consider applying after an upgrade from 10g. In the BI Administration Tool. you can no longer open the Administration Tool by double-clicking a repository file. and so on). In the Business Model and Mapping layer. and so on. The default application role hierarchy and permission grants can be changed as needed. Also notice that these permissions are not the same as those used to define access to BI objects (metadata. Policy store permissions are only used to define what BI functionality the assigned roles can access. Enter the repository password (welcome1 in this tutorial) and click OK. always use the Start menu to open the Administration Tool. please refer toOracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g and Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence Enterprise Edition.
23. dashboards. These permissions are granted by the default application roles in the default security configuration. select File > Open > Offline to open samplesales.
. expand the Sample Sales business model and notice that logical dimensions already exist: H0 Time. that the BIAdministrator role has been granted the permission to manage repositories. For more information related to new 11g metadata features. H1 Customer.
1. Notice. Caution: In 11g. please refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g.
In the Presentation layer.
.4. Notice that the H0 Time logical dimension contains two hierarchies: Fiscal Year and Year. Expand H0 Time and observe the hierarchy levels.
5. expand Sample Sales > D0 Time and observe that there are only presentation columns.
8.Year and H0 Time .
7. For logical dimensions that contain multiple logical hierarchies. multiple separate presentation hierarchies are created.6. Notice that two presentation hierarchies are created: H0 Time . Expand the presentation hierarchies and observe that they contain the same drill paths defined in the logical dimension in the Business Model and Mapping layer. Drag the H0 Time logical dimension from the Business Model and Mapping layer to the D0 Time presentation table.
Presentation hierarchies and presentation levels provide an explicit way to expose the multidimensional model in Oracle BI analyses and dashboards. When presentation hierarchies and levels are defined in the Presentation layer.
9. The errors indicate that the presentation levels for the H0 Time . roll-up information is displayed in the Analysis Editor navigation pane. providing users with important contextual information.Fiscal Year presentation hierarchy do not have display columns defined. users can create hierarchy-based queries using these objects. Select File > Check Global Consistency. Most importantly.
11.Fiscal Year presentation hierarchy.10. Expand the H0 Time .
. Minimize Consistency Check Manager.
Click the Display Columns tab.
13. Double-click the Fiscal Year presentation level to open the Presentation Level dialog box.
. Click the Add button (green plus sign) to open the Browse dialog box.14.
16. and select T45 Fscl Year. scroll.
. Click the Select button to add the column to the Presentation Level .
17. select Sample Sales.Fiscal Year dialog box. In the left pane. In the right pane.
Click OK to close the Presentation Level dialog box. Click Check All Objects and confirm that there are no errors.
21.) Fiscal Half: T44 Fscl Half Fiscal Qtr: T43 Fscl Qtr Fiscal Month: T42 Fscl Month Fiscal Week: T41 Fscl Week
20. warnings. or best practice violations. Restore Consistency Check Manager. (Hint: Use the Query button in the Browse dialog box to search for the presentation columns.18.
19. Repeat the steps to add display columns to presentation levels.
which should still be open in your browser. Close the repository. please refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition 11g and Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition. In the right pane. click the Deployment tab. If it is not open. Close Consistency Check Manager. Save the repository. In the left pane. including the default published repository.
25. you must upload the modified repository to Oracle BI Server by using Fusion Middleware Control. You can no longer manually change these configuration settings in NQSConfig.INI.
To incorporate the changes that you made to the repository in this tutorial.
Using Fusion Middleware Control in 11g
Many configuration settings that affect repository development.
1. Close the Administration Tool.
24. For more information related to using Fusion Middleware Control to manage BI configuration settings. There is no need to check global consistency again. Return to Fusion Middleware Control.22. expand Business Intelligence and select coreapplication. enter the f URL:http://localhost:7001/em and sign in as an administrative user.
3. are now centrally managed in Fusion Middleware Control.
In the Upload BI Server Repository section.
6. Click Close when you receive the ―Lock and Edit Configuration – Completed Successfully‖ confirmation me
7. click Browse to open the dialog box. Click the Repository subtab.
5. Click Lock and Edit Configuration.4.
Notice that Default RPD now displays samplesales with a new extension.
. Click Apply. for example. You can also double-click the repository to open it.8. By default. Select samplesales. the dialog box should open to the default repository directory. Enter welcome1 in the Repository Password and Confirm Password fields.rpd and click Open.
10. browse toD:\bi\instances\instance1\bifoundation\OracleBIServerComponent\coreappli
9. If not.
15. Allow Activate Changes processing to complete.
. Click Restart to apply recent changes to navigate to the Overview page. Click Close when you receive the ―Activate Changes – Com message.
14. click Restart. Click Activate Changes.
13. On the Overview page.
17.16. Allow the Restart All – In Progress processing to complete.
18. Click Close when you receive the ―Restart All – Completed Successfully‖ confirmation message. Click Yes when you receive the ―Are you sure you want to restart all BI components?‖ message.
Level-based hierarchies can also contain parent-child relationships. Hierarchies allow you to drill deeper into the data. Employees can have titles. an Employee hierarchy might have no levels.
A hierarchical column can be one of the following kinds:
Level-based hierarchy: Consists of an ordered set of two or more levels. Quarter.19. but instead have names of employees who are managed by other employees.
A hierarchical column holds data values that are organized using both named levels and parent-child relationships. For example.
. please refer to Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition 11g. Parent-child hierarchy: Consists of values that define the hierarchy in a parent-child relationship and does not contain named levels.
For more information related to new 11g presentation features for users. Individual members are shown in an outline manner. Confirm that System Components = 100%. such as Vice President.
1. This column is displayed using a tree-like structure. Vice Presidents might report to other Vice Presidents and different Vice Presidents can be at different depths in the hierarchy.
The example in this topic uses a level-based hierarchy.
Applying New 11g Presentation Features
There are many new 11g presentation features for Oracle BI users that you should considering applying after an upgrade from 10g. The samplesales repository is now loaded into BI Server. Sign in to Oracle BI. and Month. This topic covers only one new feature: using hierarchical columns in an analysis. a Time hierarchy might have three levels for Year. For example. to view more detailed information.
Create the following analysis by using the H0 Time .Year presentation hierarchy. In the Create section. Click Results.
3. select Analysis > Samples Sales.2.
If you are using the BI Publisher security model.xdo). If you are using another security model. are now spilt in 11g into two objects—a report definition file (. delivery server configurations. data source definitions. then all roles and permissions will become available to 11g as the Upgrade Assistant has that detailed information available.5.xdo) and a data model file (. and so on.
Upgrading Oracle BI Publisher Repository
The Upgrade Assistant performs the following upgrades to the BI Publisher Repository:
Upgrades reports: The reports created in 10g. Expand the hierarchy to view data at different levels. you need to address permissions separately.
Running the Upgrade Assistant for the BI Publisher Repository
. Upgrades configuration files: The Administration files.xdm). such as LDAP. containing users and roles. stored originally within a single report file (. Click this link to view a graphic representation of these structures. Note that the default security model is Fusion Middleware. are copied to the new location retaining all configuration settings.
Click Next. Start the Upgrade Assistant as you did above in the topic titled "Upgrading the Oracle BI Repository and Cata
. The Welcome page appears.To begin the upgrade for BI Publisher. perform the following steps:
1 . The Specify Operation page appears.
3 . Select Upgrade Oracle BI Publisher Repository. and then click Next.
You need to sto in a file system. and then run the Upgrade Assistant to create an equivalent data model definition in the BI Pub
. and then click Browse to locate the repository that you want to upgrade. you browse for the data template directory—No Assistant does not support reading the data definition from the E-Business Suite environment. The Specify Source Details page appears.
Select the first option. This is the loc are upgrading the E-Business Suite Data Template Directory.4 . Two options are available for selection: the first is for the BI Publis is for the E-Business Suite Data Template Directory.
Navigate to the 10g catalog and select it. For this example.5 .
. the repository is located in D:\Repository.
The image below provides a view of the directories containing the reports that will be upgraded:
Click Next. you browse for the data model directory. If you are upgrading the E-Business Suite Data Template Directory.
. 7 .%MIDDLEWARE_HOME%\user_projects\domains\bifoundation_domain\config\b or it can be a new path on the server. then you must copy the contents of the 11g rep 11g repository contains required files. The Specify Destination Details page appears. Click Browse to select the location for your upgraded repositor repository as the installed bishiphome 11g repository path (for example. If you choose a new path.
In this example. and Password (welcome1) as y topic titled "Upgrading the BI Repository and Catalog" and click Next. User Name (weblogic).
Enter the Host (localhost .
. The Specify WebLogic Server page appears. Click Next. the Administration server is running locally. the corresponds accordingly. Port (7001).8 .the default). 9 .
Click the hot link for the bottom of the dialog box). proceed.
. For example. The system is examined to ensure that everything is available and .10 The Examining Components page appears. the installer interrogates the system to ensure that there is enough space. You review the log file now or at a later time. The status is s A log file for the session is available.
. click Close. When you are finished reviewing the log file.11 Scroll and examine the content.
.12 Click Next. 13 The Upgrade Summary page appears and provides you with the details for both source and target.
. Click Upgr .
Click Next. revie . If the status is not successful.
.14 The Upgrading Components page appears. Examine the status once again. determine and resolve the issues.
15 The final page of the Upgrade Assistant Wizard page appears. Click Close. .
perform the following steps:
1 .http://localhost:7001/xmlpserver). Log in to BI Publisher and change the server configuration to point to the upgraded repository. Open a new browser window and in the address bar.
. The Oracle BI Publisher Enterprise Login window appears. enter http://<hostname>:7001/xmlpserver (for example.Verifying the BI Publisher Repository Upgrade
To verify that the upgrade ported your reports over to 11g properly.
and click Sign In.2 . Enter the Username (weblogic) and Password (welcome1). Click the Administration link. The Home Page appears.
4 . click Server Configuration. Within the System Maintenance section.
Click the Server Configuration tab.5 .
Click Apply. Enter the path for your upgraded repository into the Configuration Folder area. A confirmation message appears.%MIDDLEWARE_HOME%\user_projects\domains\bifoundation_domain\config\b
7 .6 . This is the path that you specif page in the Upgrade Assistant (for example.
9 . .User in the Fol appear in the right pane. Expand Shared Folders > HR Manager > HR .8 .
10 Select a specific report to view. Click the Catalog link on the global header. and then log back into BI Publisher to review your changes to the repository.
. Click Open for the Form P11D-UK2004 report. Log out.
The P11D-UK2004 report appears.
there are a number of considerations and tasks that should be addressed.
.xml contains the correct repository name and path to the BI Publisher repository. Some of these considerations are addressed below:
Verify that the xmlp-server-config.You have now verified that your reports have been successfully migrated. Close BI Publisher. Post Upgrade Considerations for BI Publisher 11g
After upgrading to BI Publisher 11g. This file is located in the%MIDDLEWARE_HOME%\user_projects\domains\bifoundation_domain\config\bipublisher directory.
. This file is located in the%MIDDLEWARE_HOME%\user_projects\domains\bifoundation_domain\config\bipublisher\repository\Admin\DataSourcedirectory.xml file contains the correct repository name and path to the BI Publisher repository.
Verify that the datasources.
Orphan elements: In 10g it was possible for a data template to declare an element name. To correct the issue. refer to Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence 11g.
Validation errors for upgraded data templates: The Data Model Editor in 11g introduces restrictions on data models that were not present in 10g.
This tutorial showed you how to use Oracle Fusion Middleware Upgrade Assistant to upgrade an existing Oracle Business Intelligence 10g environment to an 11g environment. however should you need to make any modifications. the data sets do not display any column information in the Data Model Editor. delete the column by using the Data Model Editor in 11g.
Editing upgraded data models: When the 10g report data model is using a SQL Query or BI Answers as the data source type. Case sensitivity and orphan elements present two restrictions of which you should be aware. a data template-based data model that was valid in 10g. you may not be able to edit the data model (for example. In 11g the case must match the referenced item. This occurs because these data set types (in 10g) do not capture the necessary information to populate the columns for the new 11g model. Therefore. you might not be able to add a calculated column or create a link to other data sets). . which referenced a column that did not exist in the SQL query. might invoke a warning message when you try to save it.Case sensitivity: The 10g data template allowed you to reference elements within the data template without regard to the case being used.
For additional information about repository metadata upgrade considerations. In 11g this construction causes an invalid warning. These data models will continue to work. In 10g this situation returned a null value for the element. .
you should have learned how to:
Install the Sample Sales 10g data set Upgrade an Oracle BI 10g repository and presentation catalog to Oracle BI 11g Verify an Oracle BI 11g upgrade Incorporate enhanced consistency checking for Oracle BI 11g repositories Incorporate modeling diagram changes for Oracle BI 11g repositories Incorporate changes to the Oracle BI 11g security model Apply new Oracle BI 11g repository metadata features Use Fusion Middleware Control to configure Oracle BI 11g Apply new Oracle BI 11g presentation features Upgrade the Oracle BI Publisher 10g repository to Oracle BI Publisher 11g
Oracle Business Intelligence Enterprise Edition Documentation Oracle Business Intelligence Enterprise Edition Online Tutorials Oracle University Oracle Technology Network Oracle Business Intelligence Discussion Forums
Lead Curriculum Developer:Jim Sarokin Other Contributors: Lea Shaw
Copyright © 2011.In this tutorial. All rights reserved
. Oracle and/or its affiliates.