OBIEE 11g SampleApp Know Issues

This document contains a list of know issues and possible workarounds when deploying and using OBIEE 11G SampleApp content. SampleApp is a free content set, not maintained by Oracle as a licensed product.

Last updated : Sept 1st 2010

Table of Contents
1 Getting Started and Using Sample App ..................................................................... 3
1.1 What are logins and passwords ?.......................................................................................... 3 1.2 How do I know more about the SampleApp Data and Datamodel ....................................... 3 1.3 How do I customize SampleApp Data .................................................................................... 3

Admintool and Repository .......................................................................................... 4

2.1 Opening Admintool from Program Menu Command only .................................................... 4 2.2 Database Features Consistency Warnings ........................................................................... 4 2.3 How so I see which exact build of SampleApp I am using ................................................... 4 2.4 One Essbase connection pool has an hardcoded IP address by default. ........................... 4

Report errors ................................................................................................................ 4

3.1 [nQSError: 64011] Internal Error : attempt to bind record to an non-existent column ....... 5 3.2 [nQSError: 42016] Check database specific features table. Must be able to push at least a single table reference to a remote database ......................................................................... 5 3.3 View Display Error : Graph server does not appear to be responding in a timely fashion. 5 3.4 [nQSError: 43119] Query Failed: Aggr Essbase Error: Network error [110]: Unable to connect to [10.228.232.106:1423]. The client timed out ........................................................ 5

Action Framework........................................................................................................ 5
4.1 Reports in Dashboard 4.1 Investigate to Invest show no results ...................................... 5

Mapviewer .................................................................................................................... 6
5.1 Map not showing up at Zoom level 0 ..................................................................................... 6

Scorecards ................................................................................................................... 6
6.1 Scorecard views in dashboards appear as blue rectangles only ........................................ 6

BIEE server ................................................................................................................... 6

7.1 No Log Found : cannot access query Logs on web browser .............................................. 7

Marketing Segments .................................................................................................... 7

8.1 Can Not Create New Marketing Segments ............................................................................ 7

Oracle OBIEE 11G SampleApp Deployment Instructions

1 Getting Started and Using Sample App

1.1 What are logins and passwords ?
You can login as your weblogic administrator user, or as any of the users indicated in the Credentials paragraph of SampleApp Deployment Instructions The RPD encryption password is Admin123

1.2 How do I know more about the SampleApp Data and Datamodel
The dashboard 1.2 Configuration shows a few high level information about SampleApp. In particular, this shows a page with the database diagram, as well as major hierarchies datasets : Products, Offices, Employees. Sample App OOB Data is simple and straightforward. Each dimension is distributed within facts against a simple rule, and there are no dependencies for values in one dimension to values in another dimension. Examples : a customer that has an address in the US may also have orders existing with ship to addresses in Asia or EMEA, there is no consistency regarding that cross distribution in the a sales employee is not assigned a particular set of customers, but can have orders from any customers etc

1.3 How do I customize SampleApp Data

There are two simple and easy possible customizations for data :

1.3.1 Changing the values of dimensions :

All dimensions but customers : simply edit the values of the dimension names for products and offices to what you need them to be. Customer dimension : some attributes in the customer dimension are fetching their descriptions from a lookup table (SAMP_LOOKUPS_D). These are marked as camera icons in the RPD. Changing the values of these attributes require you to directly updated the right language entry into SAMP_LOOKUPS_D.

1.3.2 Changing skewness, creating trends and outliers

Simply edit the SAMP_REVENUE_F fact table foreign keys. For example, if you want to skew revenue for a particular product , a particular employee, or a particular office during a time frame, just update the Fact table key values of these individuals, and increase the number of occurrences for those you need to skew revenue for. It is not recommended to update the entries of the fact metric columns themselves (revenue and quantity) as they are originally set to total to a round number (50 000 000).

Oracle OBIEE 11G SampleApp Deployment Instructions

If you want to edit skewness towards a particular geographical region : pick one or the two region hierarchies available (customer addresses objects CXX, or Order ship to addresses objects RXX), and identify which orders or customers are attached to each regions. With this information, allocate more orders to specific customers or allocate more orders to a specific region in the fact table.

1.3.3 Make sure you clear or disable OBIEE cache to see your updated data show in your reports.

2 Admintool and Repository

2.1 Opening Admintool from Program Menu Command only
Do not double click on an RPD file to open it in Admintool. Instead, always open Admintool first by navigating to your start menu/Programs/OracleBusinessIntelligence/Bi Administration. Doing so allows proper initialization variables to be loaded, which are necessary for Admintool to be functional. Ignoring this will lead to creating inconsistencies in the RPD file.

2.2 Database Features Consistency Warnings

You see may see warnings coming up claiming :
[39028] The features in Database '02 - Sample App Xml Data' do not match the defaults. This can cause query problems

You must fix each of these warnings by double clicking on each database icon in the physical layer, navigate to Features tab, and click the bottom button Reset to Defaults. This must be done for each database that has the warning message.

2.3 How so I see which exact build of SampleApp I am using

The build number is appearing in the description of the first subject area (when clicking on new request),

2.4 One Essbase connection pool has an hardcoded IP address by default.

This is for connection pool of datasource : 04 - Essbase Sample E2 (Default Import) which has IP address 10.228.232.106 hardcoded. This IP address there should have been removed, please change this by the whole following string : VALUEOF(ESSB_HOST), exactly like it is in the connection pool of datasource 03 - Essbase Sample E1.

3 Report errors
Oracle OBIEE 11G SampleApp Deployment Instructions 4

3.1 [nQSError: 64011] Internal Error : attempt to bind record to an nonexistent column
Most likely this error is happening when trying to use forecast facts, that source from the XML file SAMP_XML_TARGETS_F.xml located under
Installhome\instances\instance1\bifoundation\OracleBIServerComponent\coreapplication_obis1\sample\SampleAppFiles\Data

Make sure the correct SAMP_XML_TARGETS_F.xml (~628KB) is present in this directory. Note, this file is different from the SAMP_TARGETS_F.xml file, which is used by the OOB SampleAppLite install, that was deployed by your initial OBIEE install.

3.2 [nQSError: 42016] Check database specific features table. Must be able to push at least a single table reference to a remote database
First validate that you have completed the fix for error 2.2 in this doc Then, if problem persists, it may be related to the RPD setup of XML source file for the forecast facts. Make sure the database features for the XML source in the RPD is set to defaults, and then make sure the feature property MAX_TABLES_IN_SELECT is set to 1.

3.3 View Display Error : Graph server does not appear to be responding in a timely fashion.
Hit F5 button, the chart should show up correctly. This problem should not happen unless machine utilization load maxes up.

3.4 [nQSError: 43119] Query Failed: Aggr Essbase Error: Network error [110]: Unable to connect to [10.228.232.106:1423]. The client timed out
See item 2.4 in this document which describes the solution to this error

4 Action Framework
4.1 Reports in Dashboard 4.1 Investigate to Invest show no results

To fix this, do one of the following : Click on Add Commentary to the Dashboard action link and enter a value for Message in the window that pops up. Click Execute. Next Click on Update Customer News action link and enter a value for Message. Insert the following statements on the BISAMPLE schema within the database

Oracle OBIEE 11G SampleApp Deployment Instructions

INSERT INTO SAMP_ACTIONS(ID, MESSAGE_TYPE, ORDER_ID, USERID, FLAG, STATUS, TIMESTAMP, MESSAGE) VALUES (297569,'Customer News',0,7234,1, 4, '2010/08/09 04:47:57','Production Org to Concentrate on Efficiencies'); INSERT INTO SAMP_ACTIONS(ID, MESSAGE_TYPE, ORDER_ID, USERID, FLAG, STATUS, TIMESTAMP, MESSAGE) VALUES (361500,'Investigate',0, 7234 , 1, 4, '2010/08/06 11:00:59','The Market rose by 2% this week.'); COMMIT;

Now refresh the dashboard page and the two analysis should show values.

5 Mapviewer
5.1 Map not showing up at Zoom level 0
After creating the navteq schema, login to mapviewer console at http://localhost:9704/mapviewer. Click on Manage Map Tile Layers and choose OBIEE_WORLD_MAP (or any other tile layer). Click on View Map button. Next, click on Show Map screen. If you do not see a map when the zoom level is 0 but the map starts appearing when you change the zoom level to 1 or above, then do the following. Click Geometry Cache from the menu on the right.. Select the OBIEE_NAVTEQ_Sample datasource and then Click Purge All Themes Click Datasources from the menu on the right side.. Select the OBIEE_NAVTEQ_Sample data source, and click Purge cached metadata Click Managing Map Tile Layers from the menu at the top. Select the tile you want to clear, and click view map /manage tiles. From the screen, select all tiles from the Zoom Level Selection list box, and click Clear Tiles

6 Scorecards
6.1 Scorecard views in dashboards appear as blue rectangles only
Clearing all browser cache and temp files should help fixing that issue.

7 BIEE server
Oracle OBIEE 11G SampleApp Deployment Instructions 6

7.1 No Log Found : cannot access query Logs on web browser

Login to the EM administration screen using the url http://localhost:7001/em (Replace the hostname and port-number based on your setup). Use the login you created in BIEE installation to log in to the EM console. Expand 'Business Intelligence' node on the left and choose Coreapplication.

Now click on the Diagnostics tab on the right. Click on Log Configuration subtab Click on 'Lock and Edit Configuration' to enable you to change the default settings

Set the value of trace to at least Fine, or higher Click on Apply (top right corner of screen) Click on 'Activate Changes Restart OBIEE services (from within EM) This should confirm queries log are filed into
Installhome\instances\instance1\diagnostics\logs\OracleBIServerComponent\coreapplication_obis1\ nqquery.log

To then access physical query generated by each report, open that nqquery.log file after the report is run, navigate to the bottom of the file, you should see all the logging for the query there.

8 Marketing Segments
8.1 Can Not Create New Marketing Segments
A platform bug currently prevents from opening and creating segments using the SampleApp application. Fix will be posted as soon as identified.

Oracle OBIEE 11G SampleApp Deployment Instructions