<Insert Picture Here>

Oracle Discoverer 11g

Agenda

What is Discoverer

Discoverer Architecture

Discoverer Installation
File system architecture

OBI Discoverer 11g Configuration for Oracle EBS Integration

Oracle EBS Configuration for Oracle BI Discoverer 11g Integration

Starting & Stopping of Discoverer Services

 What is Discoverer ?

• Business user: one of key responsibility is to make quick

and effective business decision.

EBS
EBS Required
Decision Making Graphs &
Database Decision Making
Database Data Charts

Business User

• BI Discoverer is an intuitive ad-hoc query, analysis

,reporting and Web publishing tool that gives business
users immediate access to information in databases
Discoverer Architecture

• Multitier architecture
Discoverer Architecture Continuation…

The Discoverer client tier

• Discoverer Plus:
 create Interactive graphs and charts to enable end user to analyze the data
 share graphs and charts with other people
 client machine to use a supported Java-enabled Web browser
 Discoverer Plus applet is downloaded first time from the Discoverer middle tier and
cached on the Client machine.

• Discoverer Viewer:
 Is a Web tool for accessing interactive reports and charts created using Discoverer
Plus.
 End users can personalize worksheets and save their changes
Discoverer Architecture Continuation…

The Discoverer Middle tier

• Discoverer middle-tier manager maintains
Discoverer Java EE applications
Discoverer CORBA components.
Discoverer Architecture Continuation…

Discoverer Java EE applications

• Discoverer servlet manages connections and login for Discoverer Plus
and Discoverer Viewer.
• Discoverer Plus servlet handles traffic between the Discoverer Plus
Relational applet and the Discoverer Session process started for that
session.
• Discoverer Portlet Provider servlet provides a user interface for
publishing Discoverer worksheets and links to Discoverer workbooks on a
portal page
• The Discoverer Web Services servlet provides an API to obtain
Discoverer connections,workbooks,worksheets ;to execute worksheet
queries and to return worksheet content through the SOAP protocol
Discoverer Architecture Continuation…

Discoverer CORBA components.

• Responsible for activating Discoverer when an end user starts a
Discoverer session.
• Discoverer session component:
 Performs Discoverer operations such as connecting to the database or opening a workbook.
 Link between the Discoverer servlet or applet and the database.
 one Discoverer session component per active user login session.
• Discoverer Preferences server component:
 Provides a single location for preference settings for all Oracle BI Discoverer users.
 To control the Discoverer environment and the behavior of Discoverer Plus and Discoverer
Viewer
 Discoverer middle tier relies on stored preference settings to specify the default Discoverer
behavior.
 Discoverer Terms

Discoverer Terminology Database/Spreadsheet Terminology

Workbooks Group of Worksheets
Worksheets Queries/Spreadsheet
Business Area(BA) Grouping of Tables
Folders Tables
Records Rows
Items Columns
Discoverer Architecture Continuation…

Discoverer database tier

• Discoverer workbooks that are used to store reports and charts

 An End User Layer (EUL), which provides an easy-to-understand view of the data
 Business intelligence data that users want to analyze
 An Active Catalog, which is a set of relational views that expose the standard form
metadata that is stored in analytic workspaces, so that it can be accessed by SQL
 Analytic workspaces, which are multidimensional schemas stored in a relational
table.
Discoverer Installation

• Oracle Portal, Forms, Reports and Discoverer 11g Release 1 (11.1.1)

• Install Oracle FMW 11gR1 components on a standalone server accessing
an Oracle E-Business Suite Release 12 database or in a separate
ORACLE_HOME on an existing application tier server node

 Verify your system and network environment for installation

 Obtain all necessary software.
 Install Oracle Web Logic Server.
 Install but do not configure Oracle Portal, Forms, Reports and Discoverer
 Run the Patch Set Installer to update your software.
 Configure Oracle Portal, Forms, Reports, and Discoverer
 Verify your environment
File system Architecture
File system Architecture Continuation…

INSTANCE HOME:
The set of system components managed by the same OPMN entity and share single
parent directory for their configuration is referred to as Fusion Middleware instance.
 INSTANCE_HOME/bin : Contains the opmnctl command for managing the system components of this
instance.
 INSTANCE_HOME/diagnostics/logs: Contains the logfiles for each configured system components.
 INSTANCE_HOME/config: Contains the configuration files for each configured system components.
DOMAIN HOME:
 $DOMAIN_HOME/bin : Scripts for starting and stopping the administration server and the managed
servers in the domain.
 $DOMAIN_HOME/config : The current configuration and deployment state of the domain, config.xml
 $DOMAIN_HOME/init-info : Domain initialization information
 $DOMAIN_HOME/lib: JAR files added to CLASSPATH of each server instance
 $DOMAIN_HOME/pending: Domain configuration changes that have been requested, but not yet
been activated
 $DOMAIN_HOME/security: Domain wide security-related files
 $DOMAIN_HOME/servers : One subdirectory for each server in the domain
 $DOMAIN_HOME/servers/<servername> : The server directory for the WLS instance with the same
name
OBI Discoverer 11g Configuration for Oracle EBS
Integration
• Copy the EBS dbc file to the Discoverer 11.1.1
$ORACLE_INSTANCE/config/Discoverer/Discoverer_<ias-instance>
• Update $ORACLE_INSTANCE/config/tnsnames.ora file with tnsnames entry to
connect R12 EBS Database.
• Create new Discoverer 11.1.1 End User Layer:
 Create tablespace
 EUL schema name as the combination of profiles "ICX: Discoverer Default End User Layer
Schema Prefix" and "ICX: Discoverer End User Layer Language Override" as shown below.
[ICX: Discoverer Default End User Layer Schema Prefix]_[ICX: Discoverer End User Layer Language Override]
 Statement to Create EUL User

$ORACLE_HOME/bin/eulapi \
-CREATE_EUL \
-APPS_MODE \
-CONNECT system/<password>@<db> \
-USER <EUL_User_Prefix>_US \
-PASSWORD <password> \
-DEFAULT_TABLESPACE <default tablespace> \
-TEMPORARY_TABLESPACE <temp tablespace> \
-EUL_LANGUAGE US \
-APPS_GRANT_DETAILS <FNDNAM>/<FNDNAM password>
Oracle EBS Configuration for Oracle BI Discoverer
11g Integration
• Apply the latest AutoConfig patch
• Apply AD Patch containing adupdeul.sh and adrfseul.sh
12.0 -- Patch 9384228
12.1 -- Patch 9394002
• Change s_disco_url in CONTEXT FILE and run autoconfig.
• Set Applications Profile Options in Oracle E-Business Suite

ICX: Discoverer Launcher URL that points to Discoverer Plus Servlet

ICX: Discoverer Viewer Launcher
ICX: Discoverer use Viewer
ICX: Discoverer Release Single
ICX: Discoverer Parameters
Discoverer DBC filename override
URL that points to Discoverer Viewer Servlet
Specify whether Discoverer Viewer should be launched
instead of Discoverer Plus
Number specifying the Discoverer release
Used to optionally pass additional URL parameters to
Discoverer
To specify the DBC Filename Discoverer should be using to
connect to the EBS database.
Oracle EBS Configuration for Oracle BI Discoverer
11g Integration Continuation…
• Regenerate Business Views
 Oracle E-BS Release 12 Discoverer content are based on Business Views
 Run Generate Business Views by Application concurrent program
 Recompile APPS objects
 Check Business Intelligence System Views

• Set up E-BS Suite User/Responsibility for EUL Administration:

SYSADMIN/System Administrator
 System Administrator account must be granted permission to update and alter Discoverer 11.1.1
content.

ORACLE_HOME/bin/eulapi \
-CONNECT <EUL schema>/<password>@<db> \
-GRANT_PRIVILEGE \
-USER SYSADMIN \
-PRIVILEGE administration \
-PRIVILEGE all_admin_privs \
-LOG <log file name>

• Access directory $AU_TOP/discover on your E-BS Release 12 instance from

your Oracle BI Discoverer 11g instance
Oracle EBS Configuration for Oracle BI Discoverer
11g Integration Continuation…
• Import Discoverer Content for E-Business Suite Release 12 using
adupdeul.sh mode=complete
 Change directory to $AU_TOP/discover from BI Discoverer osuser.
 Source the Environment Variables
 Start import process

% sh adupdeul.sh \
connect=<APPS admin user>/<password>@<two_task>
resp=<APPS administrator responsibility>
gwyuid=<APPS GWYUID>
fndnam=<APPS FNDNAM>
secgroup=<secgroup>
topdir=<topdir>
language=US
eulprefix=<eulprefix>
iashome=<iashome>
[eultype=<eultype>]
[mode=<mode>]
[driver=<driver>]
[filelist=<filelist>]
[logfile=<logfile>]
[parfile=<parfile>]

 Check for Import Errors

Oracle EBS Configuration for Oracle BI Discoverer
11g Integration Continuation…
• Import Discoverer Content for E-Business Suite Release 12 using
adupdeul.sh mode=complete
 Change directory to $AU_TOP/discover from BI Discoverer osuser.
 Source the Environment Variables
 Start import process

% sh adupdeul.sh \
connect=<APPS admin user>/<password>@<two_task>
resp=<APPS administrator responsibility>
gwyuid=<APPS GWYUID>
fndnam=<APPS FNDNAM>
secgroup=<secgroup>
topdir=<topdir>
language=US
eulprefix=<eulprefix>
iashome=<iashome>
[eultype=<eultype>]
[mode=<mode>]
[driver=<driver>]
[filelist=<filelist>]
[logfile=<logfile>]
[parfile=<parfile>]

 Check for Import Errors

Oracle EBS Configuration for Oracle BI Discoverer
11g Integration Continuation…
• Refresh the Discoverer 11.1.1 End User Layer
 End User Layer must be refreshed against the Release 12 data model
 Ensures that all references between business areas, folders, workbooks, business views, flexfields,
and Release 12 database objects are valid.
 Change directory to $AU_TOP/discover from BI Discoverer osuser.
 Source the Environment Variables
 Start Refresh process

% sh adrfseul.sh connect=<APPS admin user>/<password>@<twotask>

resp=<APPS administrator responsibility>
gwyuid=<APPS GWYUID>
fndnam=<APPS FNDNAM>
secgroup=<APPS security group>
eulschema=<eul schema>
eulpassword=<eulpassword>
twotask=<twotask>
iashome=<iashome>
[logfile=<logfile>]
[parfile=<parfile>]
Starting & Stopping of Discoverer Services
• Oracle FMW is a flexible product that you can start and stop in different ways.
• Starting Discoverer Services
Start Admin Server
cd $DOMAIN_HOME
nohup ./startWebLogic.sh -Dweblogic.management.username=weblogic -Dweblogic.management.password=password &
Start Managed Server
cd $DOMAIN_HOME/bin
nouhup startManagedWebLogic.sh WLS_DISCO admin_url &
Start Node Manager
cd $WL_HOME/server/bin
nohup ./startNodeManager.sh &
Start System components:
cd $ORACLE_INSTANCE/bin
opmnctl startall

• Stopping Discoverer Services

Stopping system components;
cd $ORACLE_INSTANCE/bin
opmnctl stopall
stop Node Manager
kill the node manager process
Stop Managed Server
cd $DOMAIN_HOME/bin
./stopManagedWebLogic.sh
Stop Admin Server
cd $DOMAIN_HOME/bin
./stopWebLogic.sh
Troubleshooting Discoverer issues

COMPONENT LOG FILE LOCATION

opmn ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/*

Oracle Web Cache ORACLE_INSTANCE/diagnostics/logs/WebCache/<component name>/*

Oracle HTTP Server

ORACLE_INSTANCE/diagnostics/logs/OHS/<component name>/*

ORACLE_INSTANCE/diagnostics/logs/Discoverer/<component name>/*
Oracle Discoverer
ORACLE_INSTANCE/diagnostics/logs/PreferenceServer/*
ORACLE_INSTANCE/diagnostics/logs/SessionServer/<component name>/*
EM Agent
ORACLE_INSTANCE/diagnostics/logs/EMAGENT/EMAGENT/*

Admin Server DOMAIN_HOME/servers/AdminServer/logs/*

WLS_DISCO DOMAIN_HOME/servers/WLS_DISCO/logs/*