Escolar Documentos
Profissional Documentos
Cultura Documentos
The following components must be used on the Oracle E-Business Suite Release 12 instance:
Component Name Version
For more information, please refer to section About Oracle BI Discoverer installations in the Oracle
Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer 11g Release 1
(11.1.1).
Note: If your target is to install Discoverer 11.1.1.3.0 then no need to apply below one-off patch. You
can proceed from 5.1.3
5.1.2 Install required Discoverer 11.1.1 patch
Download and install following required patch on Discoverer 11g Release 1 (11.1.1) for your platform.
To upgrade Discoverer 11g PS2 (11.1.1.3.0), following the instructions in the Oracle® Fusion
Middleware Installation Planning Guide 11g Release 1 (11.1.1).
5.2. Configure Oracle Business Intelligence Discoverer 11g Release 1 (11.1.1)
5.2.1. Copy Database Connection file
Discoverer needs access to the Database Connection (dbc) file for the database you wish to connect
to. A dbc file is a text file which stores all the information required to connect to a particular database.
Copy the dbc file from the $FND_SECURE directory of the E-Business Suite Release 12instance you are
setting up Discoverer with to the Discoverer 11.1.1
$ORACLE_INSTANCE/config/Discoverer/Discoverer_asinst_1/ directory.
Save the dbc file in lowercase.
About DBC Files
The default naming convention for the .dbc file for Oracle E-Business Suite Release 12is <two_task
>.dbc
If you are getting error "Could not locate or parse the .dbc file corresponding to the given Oracle
Applications instance" when trying to connect to your E-Business Suite Release 12 instance from the
OracleBI Discoverer Connections Page, please verify the filename of your dbc file. If your dbc file
name does not match above default naming convention due to using virtual names, make a copy of
your dbc file in your $ORACLE_INSTANCE/config/Discoverer/Discoverer_asinst_1/ directory that
is the default $FND_SECURE directory on your OracleBI Discoverer node, and rename the file to match
above default naming convention.
Discoverer will attempt to find the dbc file in following order
1. $FND_SECURE/ <two_task >.dbc
2. $FND_SECURE/ <database host name >_ <two_task >.dbc
For more information about dbc files see Appendix 'Setting up and maintaining Oracle Applications' of
the Oracle Applications System Administrators Guide.
5.2.2. Update tnsnames.ora file
On your Oracle Business Intelligence Discoverer 11g Release 1 node, include the tnsnames entry to
connect to your Oracle E-Business Suite Release 12 database in file
$ORACLE_INSTANCE/config/tnsnames.ora. Use the same entry as exists in the tnsnames.ora file on
your Oracle E-Business Suite Release 12 application tier server node. The database name must
match the two_task entry in the dbc file. Verify you can establish a connection to your Oracle E-
Business Suite Release 12 database using sqlplus.
5.2.3. Enable access to the Oracle E-Business Suite Release 12 Database
If SQL*Net Access security is enabled in the E-Business Suite Release 12 database, you need to
authorize the Oracle Business Intelligence Discoverer 11g Release 1 node to access the E-Business
Suite Release 12 database through SQL*Net. Refer to step "Enable SQL*Net Access to the E-
Business Suite Database" in My Oracle Support Knowledge Document Document 376811.1.
Note: If your E-Business Suite is SSL Enabled you must also enable SSL for Discoverer.
Please refer to the Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence
Discoverer 11g Release 1 (11.1.1).
5.2.4. Implement Single Sign-On for Discoverer 11.1.1 (Optional)
There are two options for authentication and user credential management for Discoverer 11g users
who need access to E-Business Suite workbooks:
Option A Without Single Sign-On Option B With Single Sign-On
integration integration
Integration between E-Business Suite Integration between the E-Business
and Oracle Internet Directory and Suite and Oracle Internet Directory and
Oracle Single Sign On via My Oracle Oracle Single Sign On via My Oracle
Support Knowledge Document Support Knowledge Document
Document 376811.1 is optional. Document 376811.1 is mandatory.
Users may access E-Business Suite Users may access E-Business Suite
Discoverer workbooks via E-Business Discoverer workbooks via E-Business
Suite menus. Suite menus.
Drawback: E-Business Suite users Users may access E-Business Suite
whose Applications SSO Login Discoverer workbooks via Discoverer's
Types profile option is set to SSO, and Connection Manager feature from
who invoke E-Business Suite standalone Discoverer clients, with
Discoverer workbooks via Discoverer's user credentials managed in Oracle
Connection Manager feature from Internet Directory
standalone Discoverer clients will need
to have their user credentials dual-
maintained in both Oracle Internet
Directory and the E-Business Suite
FND_USER repository
Create a windows system variable FND_SECURE pointing to the directory that holds the dbc file
as detailed in Section 5, Step 5.2.1, before executing AD utility scripts
$AU_TOP/discover/adupdeul.sh, $AU_TOP/discover/adrfseul.sh
Create the new Discoverer 11.1.1 End User Layer by using the following command syntax, executed
on the standalone application server where Oracle Business Intelligence Discoverer 11g Release 1
was installed in Step 5.1.
$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 >
For example:
$ORACLE_HOME/bin/eulapi -CREATE_EUL -APPS_MODE \
-CONNECT system/manager@cus120 -USER EUL_US -PASSWORD EUL_US \
-DEFAULT_TABLESPACE discoverer -TEMPORARY_TABLESPACE temp \
-EUL_LANGUAGE US -APPS_GRANT_DETAILS apps/apps
Alternatively, you may also use the equivalent Discoverer Administrator command line on Windows.
Use the following syntax to create the End-User Layer using Discoverer Administrator:
%ORACLE_HOME%/bin/dis51adm.exe /CREATE_EUL /APPS_MODE \
/CONNECT system/manager@cus120 /USER EUL_US /PASSWORD EUL_US \
/DEFAULT_TABLESPACE discoverer /TEMPORARY_TABLESPACE temp \
/EUL_LANGUAGE US /APPS_GRANT_DETAILS apps/apps /SHOW_PROGRESS
5.6. Specify Java Virtual Machine for Discoverer Plus
Chapter'About running Discoverer Plus with different Java Virtual Machines' of the Oracle Fusion
Middleware Configuration Guide for Oracle Business Intelligence Discoverer 11g Release 1
(11.1.1)explains how to run Discoverer Plus with different Java Virtual Machines. You must configure
OracleBI Discoverer Plus to use the same Plug-in version as being used for E-Business Suite Release
12. Please also refer to My Oracle Support Knowledge Document Document 393931.1 titled
"Upgrading Sun J2SE (Native Plug-in) with Oracle Applications 12.0 for Windows Clients".
Section 6: Post-Installation Tasks
This section describes steps for configuring Oracle E-Business Suite Release 12 to use Discoverer
11.1.1, and for loading the E-Business Suite-specific content and workbooks into the Discoverer
11.1.1 End User Layer.
6.1. Apply the latest AutoConfig patch
Follow My Oracle Support Knowledge Document Document 387859.1 titled Using AutoConfig to
Manage System Configurations with Oracle E-Business Suite Release 12 and apply the latest
available AutoConfig Patch to your system.
6.2. Apply AD Patch containing adupdeul.sh and adrfseul.sh
E-Business Suite
One-off Patch
Version
12.0.x 9384228
12.1.x 9394002
Download the appropriate patch and follow the instructions provided in the patch readme to apply the
patch to your E-Business Suite installation.
6.3. Set Applications Profile Options for Discoverer using AutoConfig
Proceed with the following steps to allow AutoConfig to switch profile options for your remote,
standalone Oracle Business Intelligence Discoverer 11g Release 1 server.
Login to Oracle Applications Manager and navigate to Site Map > AutoConfig > Edit Parameters.
Specify following variable:
Variable
Title Description Value
Name
Discoverer s_disco_url Set the value of <protocol >:// <machine.domain >:
URL this variable to <port >
the base URL for example:
where http://mybi.company.com:7780
Discoverer is
available.
Run AutoConfig to generate all configuration files for the APPL_TOP and the ORACLE_HOMEs in its
supporting technology stack:
% <ADMIN_SCRIPTS_HOME >/adautocfg.sh
6.4. Set Applications profile options in Oracle E-Business Suite
Log into E-Business Suite Release 12 with the System Administrator responsibility
Navigate to the Profile > System form
Query the %Discoverer% profile options.
Ensure the following ICX profile options in Oracle E-Business Suite are set to:
Profile Description Value
ICX:
URL that points to http:// <HTTP Server >: <Port >
Discoverer
Discoverer Viewer /discoverer/viewer
Viewer ?Connect=[APPS_SECURE]
Servlet
Launcher
Specify whether
ICX: Discoverer Viewer
Discoverer should be launched Yes | No
use Viewer instead of Discoverer
Plus (default).
ICX: EUL
The EUL prefix in
Discoverer combination with the
Default End Language code make
User Layer
up the EUL owner at
runtime. For example
EUL owner EUL_US
has EUL prefix EUL.
Schema You may switch the
Prefix ICX_DEFAULT_EUL
profile at the
responsibility level if you
are planning to
implement multiple End
User Layers.
Single number
specifying the
Discoverer release.
Leave this at default
ICX: value <NULL > as there
Discoverer is no difference in 11
Release invocation of the two
supported Discoverer
releases 10g and 11g
for E-Business Suite
Release 12.
The remaining steps in this section include patching your End User Layer to the latest level and are
required only if you received new .eex files. For example, you need to complete the following steps
only if you are upgrading from E-Business Suite Release 11i to E-Business Suite Release 12, or if you
implement the Discoverer End User Layer for the first time.
If you have only migrated your existing End User Layers to Discoverer 11.1.1 without patching new
eex files, you can skip the remaining steps in this section.
If you are uncertain as to whether you have received any new eex files, you may continue with the
following steps. These steps can be reapplied any time to synchronize your End User Layer with your
latest eex file patchlevel.
6.5. Regenerate your Business Views (Conditional)
Most of the Discoverer folders delivered as part of the Oracle E-Business Suite Release 12 Discoverer
content are based on Business Views. Business Views hide the complexity of the underlying Release
12 data model from non-technical users. Before you import or refresh the Discoverer .eex files you
must regenerate all Business Views. This will enable the Discoverer import and refresh process to pull
in the translated prompts for Key and Descriptive Flex Fields of your Business Views into your End
User Layer. Make sure that every flexfield structure has at least one valid segment, and that all
flexfields are frozen and compiled.
6.5.1. Run the "Generate Business Views by Application" Concurrent Program
Regenerate your Business Views by running the "Generate Business Views by Application" concurrent
program using the Business View Setup responsibility:
• Logon to Oracle E-Business Suite as SYSADMIN
• Choose the "Business Views Setup" responsibility
• Navigate to Reports > Run > Pick Single Request > "Generate ALL Business Views"
In case you don't have "Business Views Setup" responsibility assigned to SYSADMIN user, please do
the following:
• Logon to Oracle E-Business Suite as SYSADMIN
• Choose the "System Administrator" responsibility.
• Navigate to Security > User > Define and add responsibility "Business Views Setup"
to user SYSADMIN.
For additional details and background, refer to the Oracle Applications Flexfields Guide.
6.5.2. Check for Errors
After regeneration of the Business Views has been completed, check the Business View Generator
output file. It should not contain any errors.
6.5.3. Recompile APPS objects
Recompile all objects in the APPS schema using adadmin.
6.5.4. Check Business Intelligence System Views
Ensure that the Business Intelligence System views exist and all Business Intelligence System views
are valid by issuing the following command in SQL*Plus:
% sqlplus apps/ <password >@ <db >
SQL> select object_name from user_objects
where object_type = 'VIEW' and
status = 'INVALID' and
( object_name like '%FV_%' or object_name like '%FG_%' or
object_name like '%BV_%' or object_name like '%BG_%' )and
object_name in (select sobj_ext_table from eul_us.eul5_objs);
Replace "eul_us" with the actual eul schema being used.
If necessary, recompile those objects so that all views are valid. The Discoverer refresh process may
stop if a select statement from a invalid Business Intelligence System View causes the following error:
ORA-04063: view "APPS. <View Name >"
All invalid objects and errors must be resolved before you can proceed with the next steps, including
import and refresh of the Discoverer End User Layer. Discoverer Administrator will drop End User
Layer objects with dependencies on invalid E-Business Suite objects during the refresh process.
6.6. Set up E-Business Suite User/Responsibility for EUL Administration:
SYSADMIN/System Administrator
The E-Business Suite Release 12 System Administrator account must be granted permission to
update and alter Discoverer 11.1.1 content.
6.6.1. Grant End User Layer Administration Privileges
Grant the End User Layer Administration privileges for user SYSADMIN using the following command,
executed on the standalone application server where Oracle Business Intelligence Discoverer 11g
Release 1 was installed in Step 5.1 .
$ORACLE_HOME/bin/eulapi \
-CONNECT <EUL schema >/ <password >@ <db > \
-GRANT_PRIVILEGE \
-USER SYSADMIN \
-PRIVILEGE administration \
-PRIVILEGE all_admin_privs \
-LOG <log file name >
For all further End User Layer Administration activities you must use the Oracle E-Business Suite User
with the System Administrator responsibility (e.g. SYSADMIN). This E-Business Suite user must import
and own the Workbooks and Business Areas of all future Discoverer patches and share them as
applicable with other E-Business Suite users and responsibilities.
6.6.2. Make sure user SYSADMIN has full security access to all Business Areas
This step is not necessary for the first import into a new End User Layer because the End User Layer
does not contain any Business Areas at this point. But for all subsequent future imports, ensure that
the user SYSADMIN has full access to all Business Areas.
Execute the following command on the standalone application server where Oracle Business
Intelligence Discoverer 11g Release 1 was installed in Step 5.1 .
$ORACLE_HOME/bin/eulapi \
-CONNECT <EUL schema >/ <password >@ <db > \
-GRANT_PRIVILEGE \
-USER SYSADMIN \
-BUSINESS_AREA_ADMIN_ACCESS % \
-WILDCARD \
-LOG <log file name >
6.7. Access directory $AU_TOP/discover on your E-Business Suite Release 12 instance
from your Oracle Business Intelligence Discoverer 11g BI instance
Discoverer .eex files are patched to your E-Bussiness Suite Release 12 instance, directory
$AU_TOP/discover. Those files must be accessible from the standalone application server where
Oracle Business Intelligence Discoverer 11g Release 1 was installed.
Please mount your applications tier server node, directory $AU_TOP/discover on your standalone
application server where Oracle Business Intelligence Discoverer 11g Release 1 was installed.
If you are unable to mount this directory, you can also zip and ftp the entire $AU_TOP/discover
directory. In this case, make sure that you include the directory structure (ie. use zip -r) when you
create the zip, and preserve the directory structure when you unzip the file on the standalone
application server where Oracle Business Intelligence Discoverer 11g Release 1 was installed. The
directory structure will include the import shell scripts $AU_TOP/discover/adupdeul.sh,
$AU_TOP/discover/adrfseul.sh and the language specific subdirectories containing the set of .eex
files.
6.8. Import Discoverer Content for E-Business Suite Release 12 using adupdeul.sh
mode=complete
In this step, you will run AD utility adupdeul.sh on the standalone application server where Oracle
Business Intelligence Discoverer 11g Release 1 was installed to import the Discoverer loader files
(.eex files) for Oracle E-Business Suite Release 12 into the Discoverer End User Layer. If you are
using a E-Business Suite Release 12 Vision database, you can skip this step. E-Business Suite
Release 12 Vision database already contains a pre-installed Discoverer 11.1.1 End User Layer.
6.8.1. Check Your Location
On the standalone application server where Oracle Business Intelligence Discoverer 11g Release 1
was installed, move to the mounted or copied ... /discover/ directory where adupdeul.sh is
located
6.8.2. Source Environment Variables
Before running command line scripts adupdeul.sh or adrfseul.sh, you must source environment
variables.
Source the environment script.
. $ORACLE_INSTANCE/Discoverer/Discoverer_asinst_1/util/discenv.sh
6.8.3. Improving the Speed of the Import Process
Performance of the import process greatly depends on:
• Network latency between the Oracle Business Intelligence Discoverer 11g node and the
database
• Available resources on your Oracle Business Intelligence Discoverer 11g node
Depending on these factors, the import process may take less than one hour or up to several hours to
complete for the entire set of Discoverer baseline .eex files. To minimize overhead from network
latency during the import process, it is strongly recommended that Oracle Business Intelligence
Discoverer 11g be installed on a machine that is close to the database server and has a fast network
connection.
6.8.4. Start the Import Process
Start the import process of the Discoverer loader files (.eex files) using the shell script adupdeul.sh.
Use the following syntax for the adupdeul.sh script:
% 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 >]
Where:
Parameter Description
secgroup APPS responsibility security group
topdir Top level directory where Discoverer files are available
iashome Oracle Business Intelligence Discoverer 11g Oracle Home directory
eulprefix
EUL schema prefix. For example, use eulprefix=EULfor schema
EUL_US
All parameters must be specified on a single command line or in a parameter file. Name-value pairs
must not contain spaces. For example:
PARAMETER=VALUE is acceptable
PARAMETER = VALUE will generate errors
For example:
Mount or copy the directory $AU_TOP/discover as /user1/au_top/discover
cd /user1/au_top/discover (where adupdeul.sh is located)
Start the full import of all .eex files in topdir/US, where topdir is specified as a parameter
sh adupdeul.sh \
connect=sysadmin/sysadmin-password@db \
resp="System Administrator" \
gwyuid=APPLSYSPUB/PUB \
fndnam=APPS \
secgroup="Standard" \
topdir=/user1/au_top/discover \
language=US \
eulprefix=EUL \
eultype=OLTP \
mode=complete \
iashome=/oracle/iAS/bi \
logfile=import_complete_eul_us_cust120.log
All parameters must be specified on a single command line or in a parameter file. Name-value pairs
must not contain spaces. For example:
PARAMETER=VALUE is acceptable
PARAMETER = VALUE will generate errors
For example, change your directory to the location of adrfseul.sh:
cd /user1/au_top/discover
Start the refresh process of all existing eul folders against the database
sh adrfseul.sh \
connect=sysadmin/sysadmin-password@mydb \
resp="System Administrator" \
gwyuid=APPLSYSPUB/PUB \
fndnam=APPS \
secgroup="Standard" \
eulschema=EUL_US \
eulpassword=EUL123 \
twotask=mydb \
iashome=/oracle/iAS/bi \
logfile=refresh_eul_us_mydb.log
Expect several hours for the refresh process for all Business Areas to complete, depending on your
flex structure. The refresh utility will refresh all folders in your End User Layer one by one and should
exit with status 0.
Once completed, your End User Layer is now refreshed. Flex columns have been pulled in to the
folders using the flex prompts in the language of the End User Layer as Item Display Names.
6.10. Grant Access to Responsibilities, Users, and Workbooks (Optional)
Individual Discoverer users may be granted access to specific Release 12 responsibilities, which in
turn provide access to Discoverer business areas and workbooks. Either the Discoverer eulapi
command-line utility or Discoverer Administrator can be used to associate business area access with
Release 12 responsibilities, and to identify workbook access privileges for responsibilities and users.
The procedures described in this step may be used as guidelines for planning your Discoverer
reporting security. Your Discoverer reporting strategy may be defined to reflect your corporate data
security strategy, policies, and business requirements. Discoverer security is flexible and highly
granular, and you may wish to provide broader access for specific individuals who need to be able to
see data enterprise-wide, i.e. across organizational boundaries.
Example: You may wish some HRMS Administrator to have access to HRMS - Administration
business areas, such as the Oracle Human Resources and Oracle iRecruitment. To do this, grant
access to all of the HRMS - Administration business areas to a new or existing responsibility for ex.
'Human Resources Intelligence - Administrator (OLTP)'. This responsibility may then be granted to the
individual HRMS Administrators who should have access to those areas.
6.10.1 Grant Privileges, Security and Workbook Access on Unix
You must grant security access to the Oracle E-Business Suite Release 12 responsibilities you would
like to use for each Business Area.
You may use the Discoverer eulapi command line utility on the standalone application server where
Oracle Business Intelligence Discoverer 11g Release 1 was installed in Step 5.1 to grant privileges,
business area security and workbook access.
For help on usage of the eulapi command-line utility, type:
$ORACLE_HOME/bin/eulapi -help grant_privilege
Example 1: Grant Discoverer User privileges to responsibility "Human Resources Intelligence -
Administrator (OLTP)"
$ORACLE_HOME/bin/eulapi \
-CONNECT <EUL schema >/ <password >@ <db > \
-GRANT_PRIVILEGE \
-ROLE "Human Resources Intelligence - Administrator (OLTP)" \
-PRIVILEGE all_user_privs
Example 2: Grant security access for business area "General Ledger" to responsibility "Human
Resources Intelligence - Administrator (OLTP)"
$ORACLE_HOME/bin/eulapi
-CONNECT <EUL schema >/ <password >@ <db > \
-GRANT_PRIVILEGE \
-ROLE "Human Resources Intelligence - Administrator (OLTP)" \
-BUSINESS_AREA_ACCESS "General Ledger"
6.10.2. Share Workbooks using Discoverer User or Plus Edition
You must grant shared workbook access to the Oracle E-Business Suite responsibilities to be used for
workbook analysis.
Log in to the Discoverer Desktop or Plus Edition as the E-Business Suite Administrator user who
imported the eex files in Section 6.8.
Use the Help -> About Discoverer... dialog to confirm that you are connected to the correct End
User Layer (<EULprefix >_ <Lang >; compare the import options used in above). You can change
the End User Layer in the dialog Tools -> Options -> Default EUL.
Using the Tools -> Manage Workbooks -> Select a workbook -> Share
Share the workbooks to the E-Business Suite Users and Responsibilities that should be allowed to
open the various workbooks.
6.10.3. Test Discoverer Responsibilities and Workbooks
Log in to Oracle E-Business Suite Release 12 with a userid that has been granted one of the
responsibilities defined above.
Open the Release 12 workbooks assigned to that responsibility and verify that they can retrieve and
display data.
Repeat for each responsibility that has been defined.
Congratulations!
You have completed your Oracle Business Intelligence Discoverer Release 11g (11.1.1)
implementation and your Discoverer content for Oracle E-Business Suite Release 12 is ready for use.
Section 7: Available Documentation
• Oracle Portal, Forms, Reports and Discoverer 11g Release 1 (11.1.1) Documentation
• Installing Oracle Application Server 10g with Oracle E-Business Suite Release R12
• Using Oracle Internet Directory 11gR1 Patchset 1 (11.1.1.2.0) and Oracle Single Sign-on with
Oracle E-Business Suite
Section 8: Conventions and Important Directory Locations
Conventions
The following typographical conventions are used in this document:
Convention Meaning
In examples of commands you type online, a backward slash at the end of a
\ line signifies that you must type the entire command on one line. Do not
type the backslash.
Mono space
text Represents command line text. Type this text exactly as shown.
Change Log
Date Description
Jul 15, 2009 Initial document created.
Jan 12, 2010 Added line to source discenv.sh before running adupdeul.sh.
Apr 29, 2010 Added LIB_PATH env setting for 64 bit platforms.
Aug 11, 2010 Removed note from the header as all platforms are now certified
Related
Products
• Oracle E-Business Suite > Applications Technology > Technology Components > Oracle
Applications Technology Stack
Errors
ORA-4063
Back to top
Excellent
Good
Poor
Did this document help you?
Yes
No
Just browsing
How easy was it to find this
document?
Very easy
Somewhat easy
Not easy
Cance
l
Formularende