Anda di halaman 1dari 9

Home

About

Careers

Clients

Consulting

Training

Support

Articles

Blog

Advanced Presentation Services settings for OBIEE testing &


development

Search the blog

August 7th, 2012 by Robin Moffatt

As John Minkjan pointed out a while ago, the XSD (XML Schema) for the OBIEE configuration files can yield some interesting
things. Ive been looking at obips_config_base.xsd and found the following bits of information which I think could help certain
testing and development work with OBIEE.
First off, the standard disclaimer about undocumented functionality goes here. None of this is documented, therefore I would
imagine completely unsupported, and I cant think of a valid reason for it to ever be used anywhere other than a
sandbox/development installation.

Analytics w ith Kibana and


Elasticsearch through Hadoop
part 2 Getting data into
Elasticsearch

UKOUG Partner of the Year


Aw ards
Oracle BI Cloud Service for SaaS
Application Reporting Part 1:
Integrating BICS to
Salesforce.com using REST APIs

Top Posts

Always make a backup copy of instanceconfig.xml before making changes to it. To activate the changes, restart Presentation
Services either from EM or the command line:
./opmnctl restartproc ias-component=coreapplication_obips1

Analytics w ith Kibana and


Elasticsearch through Hadoop
part 3 Visualising the data in
Kibana

Analytics w ith Kibana and


Elasticsearch through Hadoop
part 1 Introduction

The options below (except where indicated) come within the TestAutomation element of the Presentation Services
instanceconfig.xml configuration. TestAutomation is nested within ServerInstance, thus:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Oracle Business Intelligence Presentation Services Configuration File -->
<WebConfig xmlns="oracle.bi.presentation.services/config/v1.1">
<ServerInstance>
[...]
<TestAutomation>
<OutputLogicalSQL>true</OutputLogicalSQL>
</TestAutomation>
[...]
</ServerInstance>
</WebConfig>

Recent Posts

OBIEE 11g Security Week :


Managing Application Roles and
Policies, and Managing Security
Migrations and Deployments
Upgrading OBIEE to 11.1.1.7
OBIEE 11gR1 : Architecture and
Use of WebLogic Server

Keep an eye on sawlog0.log and console~coreapplication_obips1~1.log as any errors in your instanceconfig.xml will prevent
Presentation Services from starting up.

OBIEE 11g Security Week :


Connecting to Active Directory,
and Obtaining Group Membership
from Database Tables

OutputLogicalSQL

Analytics w ith Kibana and


Elasticsearch through Hadoop part 3 - Visualising the data in

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

This adds a textbox to all reports with the Logical SQL for that report. The Logical SQL is obviously available in other places
(Advanced Tab, Logical SQL view type, Usage Tracking, nqquery.log), but if you often need it to hand then this looks like the
easiest option. Its not much good if you need to present the reports to users though, since its a global setting for the whole
Presentation Services and the Logical SQL box will be there on every single report.
<TestAutomation>
<OutputLogicalSQL>true</OutputLogicalSQL>
</TestAutomation>

part 3 - Visualising the data in


Kibana

Random Posts
Create a Mobile BI App for iOS,
Android or BlackBerry w ithin 5
Days!
Rittman Mead BI Forum 2014
Abstract Scoring Now Live - For
1 Week Only!
My Journey to ODI 12c
MDS XML versus MUDE Part 2:
What is MUDE?
Getting The Users' Trust - Part 1

Tags

11g Big Data Appliance


BIP BI Publisher dw em12c

Endeca exalytics
extremebi git

goldengate
hadoop Hive init.d install

Artificially delay report response times

linux MDS XML monitoring


new features nqcmd OBIA

Three uses for this spring to mind, only one of them serious:

obiee odi odi12c

1. Friday afternoon and you want to drive your report developers round the bend. Suddenly, all reports take a long time to
run!
2. Enable this setting on Production, and then do lots of beard-stroking and brow-furrowing and impress your boss with
your Performance Tuning prowess by quietly disabling it. Hey presto, performance improved!
3. Perhaps more usefully, you can also simulate a delay in report response times to validate your performance test
measurements.

opatch Oracle Oracle BI


Applications

integrator Oracle
Endeca Oracle Endeca
Information Discovery ow b

performance Real Time

Note that if the query is already in the presentation services cache then the delay wont be honoured, so include the request
parameter Action=RefreshAll if you are using a URL call, or see ForceRefresh below.

Decisions replication
ReportService RTD runReport

sampleapp screen scripting

You need to make sure you have both Min and Max elements defined, otherwise it wont work.
<!-- delay reports by between 15 and 25 seconds) -->
<TestAutomation>
<RandomQueryDelayMinMilliseconds>15000</RandomQueryDelayMinMilliseconds>
<RandomQueryDelayMaxMilliseconds>25000</RandomQueryDelayMaxMilliseconds>
</TestAutomation>

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

oracle data

security startup testing


?

training XML

pdfcrowd.com

NewCursorWaitSeconds support for automated load test tools with


OBIEE
We can use NewCursorWaitSeconds (which comes under Cursors, not TestAutomation) to delay how long before
Searching is returned to the user very handy if the user is a tool (Jmeter, LoadRunner, etc) which would take
Searching as erroneously indicating that the report had completed running and so record an invalid response time.
If all your reports are so fast you never see this (congrats!) you can still simulate this, using the above RandomQueryDelay
settings.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>


<!-- Oracle Business Intelligence Presentation Services Configuration File -->
<WebConfig xmlns="oracle.bi.presentation.services/config/v1.1">
<ServerInstance>
[...]
<Cursors>
<NewCursorWaitSeconds>60</NewCursorWaitSeconds>
</Cursors>
[...]
</ServerInstance>
</WebConfig>

When set, a report will appear to do nothing until the data is returned, or the NewCursorWaitSeconds is exceeded. If the data
has not returned by the time NewCursorWaitSeconds is exceeded, then a Searching will be shown. From a user
experience (UX) point of view, this is absolutely the last thing we want, as a user must always get feedback from their actions
and see that a report is running hence the Searching text. So, use this option to help with performance testing, but always
make sure it is never present in an environment where real users have access to the system.
Also within Cursors you can use ForceRefresh to always bypass the Presentation Services cache. Combining both of these
gives us:
<Cursors>
<NewCursorWaitSeconds>60</NewCursorWaitSeconds>
<ForceRefresh>True</ForceRefresh>
</Cursors>

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

InstrumentDashboardPageLoad
This is a really interesting one for understanding the time profile of a page load. When enabled, it adds instrumentation into
the page sourcecode for various actions that take place whilst the page is loading. For example:
obips_profile.logPointInTime("HTML Head","Start")

At the top of each page is a set of links which open up the time profile.

The links give different options for viewing the data, including download to CSV.

CSV file for download

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

The volume and density of the data here suggests to me that this function is more useful for examining the isolated
performance of an individual report or dashboard. It is not something that youd use for volume testing particularly given the
inevitable overhead.
Enabling InstrumentDashboardPageLoad is a bit more involved that the other options, because you also have to configure
Presentation Services for the supporting resource files (javascript and css) through the URL element. On my installation the
supporting files are located in this path
$FMW_HOME/user_projects/domains/bifoundation_domain/servers/bi_server1/tmp/_WL_user/analytics_11.1.1/7dezjl/war/res/b_mozilla/common/test/pageprofileutils.js
The path might vary if you have a single WLS server (Simple) installation, it will be AdminServer instead of bi_server1, and
the 7dezjl string may differ too. You need to determine the correct path for your installation and specify it in
CustomerResourcePhysicalPath.
<ServerInstance>
[]
<TestAutomation>
<InstrumentDashboardPageLoad>true</InstrumentDashboardPageLoad>
</TestAutomation>

<URL>
<CustomerResourcePhysicalPath>/u01/app/oracle/product/fmw/user_projects/domains/bifoundation_domain/servers/bi_server1/tmp/_WL_use
<CustomerResourceVirtualPath>/analytics/res/b_mozilla</CustomerResourceVirtualPath>
</URL>
[]
</ServerInstance>
NB if URL / CustomerResourcePhysicalPath and URL/ CustomerResourceVirtualPath arent set correctly then the
instrumentation wont work, and youll see the Display Log links at the bottom of the page, instead of the top-left overlaying
the Oracle logo. If you examine the source code for the page, youll see Missing in the paths:
<link href="Missing_common/test/pageprofileutils.css" type="text/css" rel="stylesheet">
<script type="text/javascript" src="Missing_common/test/pageprofileutils.js"></script>

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

Other available options


There are some interesting options, such as integration with the Weinre (WEb INspector REmote) development tool which
could be very useful if developing advanced content for use with the new Oracle BI Mobile HD app. Other options I doubt are
of use to those outside the products development team. Here is the list:
<TestAutomation>
<InstrumentDashboardPageLoad>true</InstrumentDashboardPageLoad>

<!-- Artificially delay reports by between 15 and 25 seconds -->


<!-- Both parameters (Min & Max) must be present for it to work -->
<!-- Also requires Presentation Services cache to be disabled, see Cursors/ForceRefresh -->
<RandomQueryDelayMinMilliseconds>15000</RandomQueryDelayMinMilliseconds>
<RandomQueryDelayMaxMilliseconds>25000</RandomQueryDelayMaxMilliseconds>
<!-- Output options -->
<OutputLogicalSQL>true</OutputLogicalSQL>
<OutputReportXML>true</OutputReportXML>
<OutputChartXML>true</OutputChartXML>
<OutputXSLFO>true</OutputXSLFO>
<OutputErrors>true</OutputErrors>
<!-- disable prompt for unsaved objects - does exactly that - use with caution! -->
<DisablePromptsForUnsavedObjects>true</DisablePromptsForUnsavedObjects>
<!-- Warns when a page loads if the number of CSS is greater than that specified -->
<MaxStylesheets>30</MaxStylesheets>
<!-- Use/function of these is unclear, other than the obvious based on their name -->
<SeleniumTest>false</SeleniumTest>
<QTPTestMode>false</QTPTestMode>
<!-- Uses Weinre technology, useful for debugging mobile -->
<!-- See http://people.apache.org/~pmuellr/weinre/docs/latest/ -->
<WebInspectorRemote>
<Enabled>true</Enabled>
<URL>http://weinre.server</URL>
</WebInspectorRemote>
</TestAutomation>

Possible errors
If you use these options, watch out that they are not documented or supported! Dont be surprised if you get errors like this:

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

Related Posts:
Built-In OBIEE Load Testing with nqcmd
Introducing obi-metrics-agent an Open-Source OBIEE Metrics Collector
OBIEE Regression Testing An Introduction
Tags: instanceconfig.xml, performance, sawserver, testautomation, testing, unsupported
Share

Tw eet

10

Like

Tags: instanceconfig.xml, performance, sawserver, testautomation, testing, unsupported


Posted in Oracle BI Suite EE, Performance, Testing | 3 Comments

Comments
GERARD Says:
August 12th, 2012 at 2:26 pm

Great article and new insights on the configuration of OBIPS (presentation services).
The link to the Johns website is an internal link and not an external, then it doesnt work and return a 404 page.
Cheers
Nico

Robin Moffatt Says:


August 13th, 2012 at 7:28 am

Thanks for letting me know, Ive fixed the link.

Christian Says:
August 13th, 2012 at 8:13 pm

Excellent work Robin. Youve highlighted some very interesting forensic features here.

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

Call us now to talk about your BI project:


+44 (0) 1273 911 268 (UK) or (888) 631-1410 (USA)
or +61 3 9596 7186 (Australia & New Zealand) or
+91 997 256 7970 (India) or +32 280 882 11 (Belgium)
Hom e

Services

About Us

> Consulting
> Training
> Support

>
>
>
>

About us
About our team
Contac t us
Our clients

Consulting
Services
>
>
>
>
>
>

Projec ts
Expert Servic es
OBIEE 11g
Sustainability
On Disc overer?
Oracle DW

Training

Resources

Blog Authors

> OBIEE
Bootcamp
> OBIEE End-User
> Exalytics
> ODI 11g
Bootcamp
> Orac le BI Apps

> Articles
> Blog
> OBIEE 11g

>
>
>
>
>
>
>

Mark Rittman
Venkat J
Peter Scott
Borkur S
Mike Vickers
Robin Moffatt
Jon Mead

Rittman Mead Consulting ltd.


Registered Office : Suite B,
First Floor Moore House,
13 Black Lion Street,
Brighton, East Sussex,
BN1 1ND, United Kingdom
Company No. : 6032852
VAT No. : 900 3839 48
Rittman Mead America, Inc.
Registered Office : 4550 North Point Parkway Suite
390 Alpharetta, Georgia 30022, USA
Rittman Mead Oceania Pty Ltd.
Registered Office : 12 Moore Street,
Brighton East,
Victoria, 3187, Australia
Australian Company No. : 149 458 935
Rittman Mead Consulting Pv t Ltd.
Registered Office : Unit 105-106
Regent Prime
Whitefield Main Road
Whitefield
Bangalore
560066
Rittman Mead Belgium
Registered Office : Chausse de Louvain 426
1380 Lasne
Belgium

2010-2011 Rittm an Mead Consulting.

open in browser PRO version

Privacy Policy

E: info@rittm anm ead.com

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

Website Design & Build: tymedia.co.uk

open in browser PRO version

Are you a developer? Try out the HTML to PDF API

pdfcrowd.com

Anda mungkin juga menyukai