Using Discoverer 10.1.

2 with Oracle E-Business Suite 11i

Section 1: Preinstallation Tasks
Ste 1: Downloa! "lication 10.1.2 so#tware.
as_linux_x86_bi_101202_disk1.cpio
as_linux_x86_bi_101202_disk2.cpio
Ste 2: e$tract the s%w using the #ollowing co&&an!.
cat as_linux_x86_bi_101202_disk1.cpio |cpio idmv
cat as_linux_x86_bi_101202_disk2.cpio |cpio idmv
Ste ': (heck the oerating s)ste& re*uire&ents +vi /etc/sysctl.conf,. an! change accor!ingl) in sysctl.conf #ile
an! save it +take the -acku o# the #ile,.
.vi %etc%s)sctl.con#
net.ipv4.ip_forward 0
net.ipv4.conf.default.rp_filter 1
net.ipv4.conf.default.accept_source_route 0
kernel.s!sr" 0
kernel.core_uses_pid 1
kernel.s#mall 20$%1&2
kernel.s#mmax 42$4$6%2$&
kernel.s#mmni40$6
kernel.ms'mni 28%8
kernel.ms'max 81$2
kernel.ms'mnb 6&&(&
fs.file)max 2061%(
net.ipv4.ip_local_port_ran'e 10000 6&000
net.core.rmem_default 1048&%6
net.core.rmem_max 1048&%6
net.core.wmem_default 262144
net.core.wmem_max262144
kernel.sem 2&6 (2000 100 142
kernel.#ostname a"#erptestdb
kernel.domainname "udra#.com
an! #ollow the /E"D0E.t$t instruction #ro& un!er this !irector)
Disk1%utils%'112324 where )ou e$tracte! the s%w.
Ste 5: create one #ol!er Discoverer. +6a&e is Otional7 here 8 create! er!isk un!er %s0'%E/P,
*cd +s0(+,-.
*mkdir erpdisk
Section2: 8nstallation Task.
Ste 1: 8nstall Discoverer.
1. 'oto Disk1 and execute t#e .%run8nstaller command
2. it will open t#e /nstaller 0ialo' box. 1elect 6e$t
(. 1elect appropriate Path b! 2lickin' t#e Browse button 3ex4) +s0(+,-.+erpdisk5 and 2lick 6e$t.
5. it will c#eck t#e 6peratin' s!stem re"uirements7 all s#ould meet t#e re"uirements t#en onl! proceed to 6e$t.
&. 1elect 8an'ua'e and click on 6e$t.
1. 1elect auto&atic and click on 6e$t.
%. 9ive t#e 1:;. server address in m! case it is 3a"re)owa."udrare.ae5. and click on 6e$t.
8. 'ive t#e na&e o# the 8nstance 3ex4) ,-.5 and enter t#e ias9a!&in password7 <nd 2lick 6e$t.
$. 2lick on 8nstall button.
10. /t will start t#e installation process.
11. ,nd of t#e installation it will ask !ou to run t#e root.s# file from t#e user as seen in t#e dialo' box.
/n m! case it is 3=+s0(+,-.+erpdisk+root.s#>5. run t#e file from root and click ok.
12. ;#en it will do confi'uration wait till it completes and click on 6E:T.
1(. 2op! t#e links from t#e end of installation 0ialo' box and click on E$it.
14. 6pen t#e ?-8 w#ic# !ou copied in /nternet ,xplorer usin' ias_admin user and t#e .assword w#ic# !ou #ave
'iven in previousl!7 from #ere !ou can start and stop all t#e services of t#e discoverer.
Ste 2: set the environ&ent #or Discoverer in .bash_profile
E$:-
export 80_<11?:,_@,-A,82.4.1$
export 6-<28,_B<1,+s0(+,-.
export 6-<28,_1/0,-.
export 6-<28,_;,-:xterm
export A81_8<A9<:,-/2<A
export 6-<28,_C6:,*6-<28,_B<1,+erpdisk
export 6.<;2C*6-<28,_C6:,+6.atc#
export ;A1_<0:/A+s0(+,-.+erpdisk+network+admin
.<;C*.<;C4*C6:,+bin4*6-<28,_C6:,4*6-<28,_C6:,+bin4*;A1_<0:/A
Ste ' : (o) Data-ase (onnection #ile.
/n t#e 0iscoverer10' *6-<28,_C6:,+opmn+conf+opmn.xml file c#eck t#e variable for DA0_1,2?-,. ;#is
variable specifies t#e director! w#ere 0iscoverer is tr!in' to locate dbc files. B! default t#is is set
to *6-<28,_C6:,+discoverer+secure.
2reate t#e director! *6-<28,_C6:,+discoverer+secure if it does not exist. ;#en cop! t#e dbc file from
t#e *DA0_;6.+secure director! of t#e 11i instance !ou are settin' up 0iscoverer wit# to t#e 0iscoverer
10.1.2 *6-<28,_C6:,+discoverer+secure director! !ou Eust created.
Ste 5: U!ate tnsna&es.ora #ile
6n !our standalone 6racle Business /ntelli'ence 1erver 10' -elease 2 node7 update
file *6-<28,_C6:,+network+admin+tnsnames.ora and include t#e tnsnames entr! to connect to !our 6racle ,)
Business 1uite -elease 11i database. ?se t#e same entr! as exists in t#e tnsnames.ora file on !our 6racle ,)Business
1uite -elease 11i application tier server node. ;#e database name must matc# t#e two_task entr! in t#e dbc file.
Ferif! !ou can establis# a connection to !our 6racle ,)Business 1uite -elease 11i database usin' s"lplus.
Ste 3: create ta-lesace #or the Discoverer in )our 11i"lication Data-ase.
*s"lplus +A6869
1G8H connect s!s+Is!s_passwordH as s!sdba
1G8H create tablespace 0/126F,-,- datafile J
KL0B_6-<28,_C6:,M+dbf+discoverer01.dbfK siNe 200: reuse J
extent mana'ement local uniform siNe 128@O
1G8H +
1tatement .rocessed
Ste 1: Sto the o&n services.
9oto *0/126F,-,- 6-<28,_C6:,.
,x4)
*cd +s0(+,-.+erpdisk+opmn+bin
* .+opmnctl stopall it will stop all t#e services. ,it#er !pu can use wit# t#e 0iscoverer link.
Ste 2: "l) the latest certi#ie! Discoverer Plus an! ;iewer Patches.
&$8(622 ) 6racle 0iscoverer 10.1.2.(. <ppl! t#is patc# on t#e top of t#e 6racle 0iscoverer folder
3ex4) +s0(+,-.+erpdisk57 w#ile runnin' t#is patc# it will ask for t#e pat#
w#ere !ou installed t#e 0iscoverer 10.1.2 t#en we need to mention t#e
pat# t#en it will up'rade t#e version to 10.1.(.
%111842 ) <ppl! 2umulative .atc#.
Ste 4: (reate new Discoverer 10.1.2 En! User <a)er.
2reate t#e new 0iscoverer 10.1.2 ,nd ?ser 8a!er b! usin' t#e followin' command7 executed on t#e standalone
application server w#ere 6racle Business /ntelli'ence 1erver 10' -elease 2 was installed.
*6-<28,_C6:,+bin+eulapi
)2-,<;,_,?8
)<..1_:60,
)26AA,2; s!stem+IpasswordHPIdbH
)?1,- I,?8_?ser_.refixH_?1
).<11Q6-0 IpasswordH
)0,D<?8;_;<B8,1.<2, Idefault tablespaceH
);,:.6-<-R_;<B8,1.<2, Itemp tablespaceH
),?8_8<A9?<9, ?1
)<..1_9-<A;_0,;</81 IDA0A<:H+IDA0A<: passwordH
;#is command s#ould be entered on a sin'le command line )) it is s#own above on separate lines wit# extra spaces
for ease of reference onl!.
Dor example4
*6-<28,_C6:,+bin+eulapi )2-,<;,_,?8 )<..1_:60, J
)26AA,2; s!stem+mana'erPcus11& )?1,- ,?8_?1 ).<11Q6-0 ,?8_?1 J
)0,D<?8;_;<B8,1.<2, discoverer );,:.6-<-R_;<B8,1.<2, temp J
),?8_8<A9?<9, ?1 )<..1_9-<A;_0,;</81 apps+apps
8n 0)case 8 e$ecute! as #ollows
=O/"(<E9>O0E%-in%eulai
-(/E"TE9EU<
-"PPS90ODE
-(O66E(T s)ste&%&anager?E/P
-USE/ EU<9US
-P"SS@O/D EU<9US
-DEA"U<T9T"B<ESP"(E !iscoverer
-TE0PO/"/B9T"B<ESP"(E te&
-EU<9<"6CU"CE US
-"PPS9C/"6T9DET"8<S as%as
Ste D: Seci#) Eava ;irtual 0achine #or Discoverer Plus
Rou can c#oose to run 6racleB/ 0iscoverer .lus wit# eit#er t#e 1un Sava 1.4 .lu')in or 6racle S/nitiator 1.(.x.
2#apter &.$ of t#e Oracle Business Intelligence Discoverer Configuration Guide 10g (10.1.2) explains #ow to run
0iscoverer .lus wit# different Sava Firtual :ac#ines. /f !ou are usin' S/nitiator7 please note t#at 0iscoverer 10.1.2 is
not supported to run wit# S/nitiator 1.1.8. Rou must use S/nitiator 1.(.
,xample4 ;o confi'ure 6racleB/ 0iscoverer .lus to use S/nitiator 1.(.1.24 b! default4
8o'on to ,nterprise :ana'er on t#e 6racle Business /ntelli'ence 10' -elease 2 6-<28,_C6:, usin'
t#e ias_admin account.
1elect t#e T6racle Business /ntelli'ence 10' -elease 2 6racle ComeT /nstance
1elect T0iscovererT
1elect T0iscoverer .lusT
1elect T2onfi'uration Sava .lu'inT
/n t#e TSava .lu'inT section switc# t#e drop)down list from T1un Sava .lu'in 31.45T to T6racle S/nitiatorT.
.ress T6@T to appl! t#e c#an'es.
6n t#e 6racle Business /ntelli'ence 10' -elease 2 files!stem7 open t#e
file *6-<28,_C6:,+discoverer+confi'+confi'uration.xml
Dind t#e line wit# t#e ta' IEvm nameTEinitiatorT+H7 for example
IEvm nameTEinitiatorT classidTclsid4("AE("AE-001'-0001-0022-"B(DEA"B(DEAT
plu'in_setupThtt:%%&)-i.co&an).co&:2240%Finitiator%Finit.e$eT versionT1.'.1.22T versionieT17'71722T
t!peTapplication+x)Einit)appletT plu'in_pa'eT+.lus.lu'in.a'e.uixT disco_arc#iveTdisco&i.EarT
d4o_arc#iveTd4o_double.EarT+H
?pdate t#e line and specif! usa'e of S/nitiator 1.(.1.247 for example
IEvm nameTEinitiatorT classidTclsid4("AE("AE-001'-0001-0025-"B(DEA"B(DEAT
plu'in_setupThtt:%%&)-i.co&an).co&:2224%Finitiator%Finit1'125.e$eT versionT1.'.1.25T
versionieT17'71725T t!peTapplication+x)Einit)appletT plu'in_pa'eT+.lus.lu'in.a'e.uixT
disco_arc#iveTdisco&i.EarT d4o_arc#iveTd4o_double.EarT+H
1ave t#e confi'uration.xml file
2op! t#e S/nitiator 1.(.1.24 executable to t#e *6-<28,_C6:,+Einit director! as Einit1(124.exe.
-estart t#e 0iscoverer services usin' opmn.
Ferif! t#at 0iscoverer .lus is now usin' S/nitiator 1.(.1.244
#ttp4++m!bi.compan!.com4%%80+discoverer+plus
/f !ou wis# to selectivel! use eit#er t#e 1un .lu')in or S/nitiator for different users or 'roups7 0iscoverer supports
specif!in' t#e desired Sava Firtual :ac#ine on t#e ?-8 usin' t#e _Evm_name parameter. Rou can specif!
values sun or Einitiator.
,xample4
#ttp4++m!bi.compan!.com4%%80+discoverer+plusU_Evm_namesun
0iscoverer .lus will use t#e 1un .lu')in.
Dor 0iscoverer .lus invocation from ,)Business 1uite -elease 11i functions7 !ou can specif!
t#e _Evm_name parameter wit# t#e profile option /2V4 0iscoverer .arameters at t#e 1ite+<pp+-esp+?ser level to
selectivel! use t#e 1un .lu')in or S/nitiator for 'iven user 'roups.
Dor more information on S/nitiator7 see :eta8ink Aote 124606.1 titled TUpgrading Oracle JInitiator it! Oracle
"pplications 11iT.
Section ': Postinstallation Tasks
Ste1 : "l) necessar) Oracle "lications interoera-ilit) atches using "utoPatch.
1.1 "l) "D atches 3213'15 an!
;#ese patc#es contains utilities for 0iscoverer ,nd ?ser 8a!er maintainance.
0ownload patc# &%6&(14 from 6racle :etalink.
Dollow t#e instructions in t#e -,<0:, to appl! t#e patc#
0ownload patc# 64&$%$6 from 6racle :etalink.
Dollow t#e instructions in t#e -,<0:, to appl! t#e patc#
1.2 "l) 8(: atch '1''021
;#is patc# contains support to invoke 0iscoverer from ,)Business 1uite functions.
0ownload patc# (1((021 from 6racle :etalink.
Dollow t#e instructions in t#e -,<0:, to appl! t#e patc#
1.' "l) "O< atch 15'021D.
0ownload patc# 64(026$ from 6racle :etalink.
Dollow t#e instructions in t#e -,<0:, to appl! t#e patc#
1.5 "l) the latest "uto(on#ig atch
Aollow 0eta<ink 6ote 1131D3.1 title! Using AutoConfig to Manage System Configurations with Oracle E
!usiness Suite ""i an! al) the latest availa-le "uto(on#ig Patch to )our s)ste&.
Ste2. Set "lications Pro#ile Otions #or Discoverer using "uto(on#ig
B! default7 <uto2onfi' confi'ures profile options for 6racle ,)Business 1uite -elease 11i environments for
0iscoverer 4i. .roceed wit# t#e followin' steps to allow <uto2onfi' to switc# profile options for !our remote7
standalone 6racle Business /ntelli'ence 10' -elease 2 server4
,dit t#e <uto2onfi' context file.
/f !ou are currentl! usin' ,)Business 1uite level 11.&.$ or above7 or #ave applied DA0.9 patc#set 3or above57 !ou
will use 6racle <pplications :ana'er to edit !our context file. Dor all previous versions7 !ou will use t#e <uto2onfi'
2ontext ,ditor tool.
;o edit t#e context file usin' 6racle <pplications :ana'er7 lo'in to 6racle <pplications :ana'er and navi'ate to 1ite
:ap H <uto2onfi' H ,dit .arameters.
;o edit t#e context file usin' t#e <uto2onfi' 2ontext ,ditor tool7 enter t#e followin' commands4
W cd L26::6A_;6.M+util+editcontext+
W .+editcontext
1pecif! variables as listed in t#e table below4
Title ;aria-le 6a&e Descrition ;alue
2onfi'ure
standalone
discoverer
s_disco_standalone 1et t#e value of t#is
variable to KtrueK if ,)
business suite 11i is
confi'ured to use a
standalone discoverer
server
true X
0iscoverer
mac#ine
name
s_disco_mac#ine 1et t#e value of t#is
variable to t#e mac#ine
confi'ured to run
0iscoverer services
Imac#ine.domainH
for
example4ap6162rt.us.oracle.com
0iscoverer
port
s_disco_port 1et t#e value of t#is
parameter to t#e port on
w#ic# t#e C;;. listener is
listenin' for 0iscoverer
re"uests
Iport numberH
for example4 %%%8
0iscoverer
protocol
s_disco_protocol 1et t#e value of t#is
variable to t#e appropriate
protocol used for accessin'
discoverer. <cceptable
values for t#is parameter
are #ttp or #ttps
#ttp | #ttps
0isco
Fersion
2omma
s_disco_ver_comma 0isco Fersion 107172
0iscover!
,?8 prefix
s_disco_eul_prefix 0iscover! ,?8 prefix ,?8
0iscover!
1ervice
1tatus
s_discostatus 0iscoverer 10.1.2 is bein'
installed in a new
standalone 6racle
<pplication 1erver 10'
6racleCome and replaces
t#e 0iscoverer 4i service
embedded in t#e i<1
1.0.2.2 based 11i
6racleCome. ;#is option
disables t#e 0iscoverer 4i
service.
disabled
6ote
X Q#en s_disco_standalone is set to KfalseK7 <uto2onfi' will confi'ure 0iscoverer mac#ine7
port7 protocol7 version to use t#e 0iscoverer version installed in t#e 6racle <pps -apid /nstall
mid tier server node.
X Q#en s_disco_standalone is set to KtrueK7 <uto2onfi' will use specified <uto2onfi' variables
0iscoverer mac#ine7 port7 protocol7 version.
6t#er 0iscoverer related <uto2onfi' parameters are not relevant for 0iscoverer 10.1.2
confi'uration because <uto2onfi' does not control confi'uration of t#e remote7 standalone
6racle Business /ntelli'ence 10' -elease 2 server node.
;#e c#an'es will be saved in !our <pplications 2ontext Dile I<..8_;6.H+admin+Idatabase 1/0H.xml.
-un <uto2onfi' to 'enerate all confi'uration files for t#e <..8_;6. and t#e 6-<28,_C6:,s in its supportin'
tec#nolo'! stack4
W I26::6A_;6.H+admin+scripts+I26A;,V;_A<:,H+adautocf'.s#
Dor furt#er information about <uto2onfi' please refer to :eta8ink Aote 16&1$&.1 titled TUsing "utoConfig to
#anage $%ste& Configurations it! Oracle "pplications 11iT.
Ste'. ;eri#) "lications ro#ile otions in Oracle "lications
8o' into -elease 11i wit# t#e 1!stem <dministrator responsibilit!
Aavi'ate to t#e .rofile H 1!stem form
Guer! t#e W0iscovererW profile options.
Ferif! t#e followin' /2V profile options in 6racle <pplications4
Pro#ile Descrition ;alue
/2V_0/126F,-,-_8<?A2C,-?-8 t#at points to 0iscoverer 1erver
8aunc# pa'e
#ttp4++IC;;. 1erverH4I.ortH
+discoverer+plus
U2onnectL<..1_1,2?-,M
/2V_0/126F,-,-_F/,Q,-_8
<?A2C,-
?-8 t#at points to 0iscoverer Fiewer
1ervlet
#ttp4++IC;;. 1erverH4I.ortH
+discoverer+viewer
U2onnectL<..1_1,2?-,M
/2V_0/126F,-,-_-,8,<1, 1 di'it number specif!in' t#e 0iscoverer
release
10
/2V_0/126F,-,-_?1,_F/,Q
,-
1pecif! w#et#er 0iscoverer Fiewer s#ould
be launc#ed instead of 0iscoverer .lus
3default5.
R | A
/2V_0,D<?8;_,?8 /2V4 0iscoverer ,nd ?ser 8a!er 1c#ema ,?8
.refix
;#is is t#e ,?8prefix. ;#e ,?8prefix in
combination wit# t#e 8an'ua'e code make
up t#e ,?8 owner at runtime.
/2V_0/126F,-,-_,?8_8<A9
?<9,
/2V4 0iscoverer ,nd ?ser 8a!er 8an'ua'e
6verride
1ince t#e ,nd ?ser 8a!er content is
currentl! available in ?1 ,n'lis# onl!7 it is
possible to override t#e userKs 'eneral
lan'ua'e preference for t#e 0iscoverer ,nd
?ser 8a!er usin' t#is profile option. ;#e
specified ,nd ?ser 8a!er lan'ua'e will be
used re'ardless of t#e individual userKs
lan'ua'e preferences.
;#is profile does not affect t#e Aational
8an'ua'e 1upport parameters passed to
0iscoverer. ;#e 0iscoverer ?ser /nterface
will still appear accordin' to t#e
users /2V_8<A9?<9, and /2V_;,--/
;6-Rprofiles. ;#e ?ser /nterface lan'ua'e
will onl! c#an'e for valid combinations
of /2V_8<A9?<9, and/2V_;,--/;6-
R.
?1
/2V_0/126F,-,-_.<-<:,;,
-1
/2V4 0iscoverer .arameters
;#is profile can be used to confi'ure t#e
,xit ?-8.
/n addition to t#at it ma! be used to
optionall! pass additional ?-8 parameters
to 0iscoverer. 2ompare Aote 186120.1 on
6racle :eta8ink.
exit?-8I,)Business 1uite Come
.a'eH
for example
exit?-8#ttp4++IC;;.
1erverH4I.ortH
+6<_C;:8+6<.EspU
6<Dunc6<C6:,.<9,

6ote
Rou ma! switc# t#e /2V_0,D<?8;_,?8 profile at t#e responsibilit! level if !ou are
plannin' to implement multiple ,nd ?ser 8a!ers. Dor example4
,?8_?1 for Business /ntelli'ence 1!stem content
,?8,0Q_?1 for ,mbedded 0ata Qare#ouse content
;#en !ou can set /2V_0,D<?8;_,?8 to ,?8,0Q for ,mbedded 0ata Qare#ouse
responsibilities like TDinancials /ntelli'ence ) ,nterprise 0ata Qare#ouseT. ;#ose
responsibilities will t#en use t#e ,mbedded 0ata Qare#ouse ,nd ?ser 8a!er.

;#e remainin' steps include patc#in' !our ,nd ?ser 8a!er to t#e latest level and are re"uired onl) if !ou received
new .eex files7 for example if !ou mi'rate to 0iscoverer 10.1.2 as part of uptakin' a ,)Business 1uite 11i
:aintainance .ack release7 or if !ou implement t#e 0iscoverer ,nd ?ser 8a!er for t#e first time.
Ste5. /egenerate )our Business ;iews
:ost of t#e 0iscoverer folders delivered as part of t#e 6racle ,)Business 1uite -elease 11i 0iscoverer content are
based on Business Fiews. Business Fiews #ide t#e complexit! of t#e underl!in' -elease 11i data model from non)
tec#nical users. Before !ou import or refres# t#e 0iscoverer .eex files !ou must re'enerate all Business Fiews. ;#is
will enable t#e 0iscoverer import and refres# process to pull in t#e translated prompts for @e! and 0escriptive Dlex
Dields of !our Business Fiews into !our ,nd ?ser 8a!er. :ake sure t#at ever! flexfield structure #as at least one
valid se'ment7 and t#at all flexfields are froNen and compiled.
5.1. <ppl! Business Fiew 9enerator patc# patc# 2$21686 usin' <uto.atc#.
6ote
/f !ou are on 6racle ,)Business 1uite 11.3.10 or a-ove !ou can skip t#is step and proceed
wit# 1tep 4.2.;#is .atc# is included in 6racle ,)Business 1uite 11.3.10 an! a-ove.
5.1.1. 0ownload t#e Business Fiew 9enerator patc# 2$21686 from 6racle :etalink
5.1.2. Dollow t#e instructions in t#e -,<0:, to appl! t#e patc#.
5.2. -e'enerate !our Business Fiews b! runnin' t#e T9enerate Business Fiews b! <pplicationT concurrent pro'ram
usin' t#e Business Fiew 1etup responsibilit!4
8o'on to 6racle <pplications as 1R1<0:/A
2#oose t#e TBusiness Fiews 1etupT responsibilit!
Aavi'ate to -eports H -un H .ick 1in'le -e"uest H T9enerate <88 Business FiewsT
/n case !ou dont #ave TBusiness Fiews 1etupT responsibilit! assi'ned to 1R1<0:/A user7 please do t#e followin'4
8o'on to 6racle <pplications as 1R1<0:/A
2#oose t#e T1!stem <dministratorT responsibilit!
Aavi'ate to 1ecurit! H ?ser H 0efine and add responsibilit! TBusiness Fiews 1etupT to user 1R1<0:/A.
Dor additional details and back'round7 refer to t#e Oracle "pplications 'le(fields Guide .
5.'. <fter re'eneration of t#e Business Fiews #as been completed7 c#eck t#e Business Fiew 9enerator output file. /t
s#ould not contain an! errors.
5.5. -ecompile all obEects in t#e <..1 sc#ema usin' adadmin.
5.3. ,nsure t#at t#e Business /ntelli'ence 1!stem views exist and all Business /ntelli'ence 1!stem views are valid b!
issuin' t#e followin' command in 1G8X.lus4
W s"lplus apps+IpasswordHPIdbH
1G8H select obEect_name from user_obEects
w#ere obEect_t!pe KF/,QK and
status K/AF<8/0K and
3 obEect_name like KWDF_WK or obEect_name like KWD9_WK or
obEect_name like KWBF_WK or obEect_name like KWB9_WK 5O
/f necessar!7 recompile t#ose obEects so t#at all views are valid. ;#e 0iscoverer refres# process ma! stop if a select
statement from a invalid Business /ntelli'ence 1!stem Fiew causes t#e followin' error4
6-<)0406(4 view T<..1.IFiew AameHT
"ttention
<ll invalid obEects and errors must be resolved before !ou can proceed wit# t#e next steps7
includin' import and refres# of t#e 0iscoverer ,nd ?ser 8a!er. 0iscoverer <dministration
,dition will drop ,nd ?ser 8a!er obEects wit# dependencies on invalid <pplications obEects
durin' t#e refres# process.
Ste 3. Set u "lications User%/esonsi-ilit) #or EU< "!&inistration: SBS"D086%S)ste& "!&inistrator
;#e -elease 11i 1!stem <dministrator account must be 'ranted permission to update and alter 0iscoverer 10.1.2
content.
3.1. 9rant ,nd ?ser 8a!er <dministration .rivile'es
9rant t#e ,nd ?ser 8a!er <dministration privile'es for user 1R1<0:/A usin' t#e followin' command7 executed on
t#e standalone application server w#ere 6racle Business /ntelli'ence 1erver 10' -elease 2 was installed
*6-<28,_C6:,+bin+eulapi J
)26AA,2; I,?8 sc#emaH+IpasswordHPIdbH J
)9-<A;_.-/F/8,9, J
)?1,- 1R1<0:/A J
).-/F/8,9, administration J
).-/F/8,9, all_admin_privs J
)869 Ilo' file nameH
Dor all furt#er ,nd ?ser 8a!er <dministration activities !ou must use t#e 6racle <pplications ?ser wit# t#e 1!stem
<dministrator responsibilit! 3e.'. 1R1<0:/A5. ;#is <pplications user must import and own t#e Qorkbooks and
Business <reas of all future 0iscoverer patc#es and s#are t#em as applicable wit# ot#er <pplications users and
responsibilities.
3.2. :ake sure user 1R1<0:/A #as full securit! access to all Business <reas
;#is step is not necessar! for t#e first import into a new ,nd ?ser 8a!er because t#e ,nd ?ser 8a!er does not contain
an! Business <reas at t#is point. But for all subse"uent future imports7 ensure t#at t#e user 1R1<0:/A #as full
access to all Business <reas.
,xecute t#e followin' command on t#e standalone application server w#ere 6racle Business /ntelli'ence 1erver 10'
-elease 2 was installed in 1tep 1
*6-<28,_C6:,+bin+eulapi J
)26AA,2; I,?8 sc#emaH+IpasswordHPIdbH J
)9-<A;_.-/F/8,9, J
)?1,- 1R1<0:/A J
)B?1/A,11_<-,<_<0:/A_<22,11 W J
)Q/802<-0 J
)869 Ilo' file nameH
Ste1. "ccess !irector) ="U9TOP%!iscover on )our E-Business Suite 11i instance #ro& )our Oracle Business
8ntelligence 10g B8 instance
0iscoverer .eex files are patc#ed to !our application tier server node7 director! *<?_;6.+discover . ;#ose files must
be accessible from t#e standalone application server w#ere 6racle Business /ntelli'ence 1erver 10' -elease 2 was
installed.
.lease mount !our applications tier server node7 director! *<?_;6.+discover on !our standalone application server
w#ere 6racle Business /ntelli'ence 1erver 10' -elease 2 was installed.
/f !ou are unable to mount t#is director!7 !ou can also Nip and ftp t#e entire *<?_;6.+discover director!. /n t#is
case7 make sure t#at !ou include t#e director! structure 3ie. use Nip )r5 w#en !ou create t#e Nip7 and preserve t#e
director! structure w#en !ou unNip t#e file on t#e standalone application server w#ere 6racle Business /ntelli'ence
1erver 10' -elease 2 was installed. ;#e director! structure will include t#e import s#ell
scripts *<?_;6.+discover+adupdeul.s#7*<?_;6.+discover+adrfseul.s# and t#e lan'ua'e specific subdirectories
containin' t#e set of .eex files.
6ote
<inu$ Users onl) :
-eplace t#e line 80_<11?:,_@,-A,82.4.1$ wit# followin' lines in
*6-<28,_C6:,+discoverer+discwb.s# before import+refres# t#e ,?8.
@,-A,8_F,-1/6AY+bin+uname )r | cut )d T)T )f1Y
if L *@,-A,8_F,-1/6A Z 2.4.21 MO t#en
export 80_<11?:,_@,-A,82.4.1$
else
export 80_<11?:,_@,-A,82.4.21
fi
Aote 40o not set 80_<11?:,_@,-A,8 for 6peratin' 1!stems -C,8&76,8&718,110. <nd for
-C<1 2.1 set its value as 2.2.&
6ote
@in!ows Users onl) :
2reate a windows s!stem variable DA0_1,2?-, wit# value as per 1ection &7 1tep 1.47 before
executin' <0 utilit! scripts !ou Eust accessed from !our ,)Business 1uite -elease 11i instance7 ie.
*<?_;6.+discover+adupdeul.s#7 *<?_;6.+discover+adrfseul.s#
Ste 2. 8&ort Discoverer (ontent #or /elease 11i using a!u!eul.sh &o!eGco&lete
/n t#is step7 !ou will run <0 utilit! adupdeul.s# on t#e standalone application server w#ere 6racle Business
/ntelli'ence 1erver 10' -elease 2 was installed to import t#e 0iscoverer loader files 3.eex files5 for 6racle ,)
Business 1uite -elease 11i into t#e 0iscoverer ,nd ?ser 8a!er.
2.1. 6n t#e standalone application server w#ere 6racle Business /ntelli'ence 1erver 10' -elease 2 was installed7
move to t#e mounted or copied ... +discover+ director! w#ere adupdeul.s# is located
2.2. 1tart t#e import process of t#e 0iscoverer loader files 3.eex files5 usin' t#e s#ell script adupdeul.s#.
1!ntax for t#e adupdeul.s# script4
W s# adupdeul.s#
connectI<..1 admin userH+IpasswordHPItwo_taskH
resI<..1 administrator responsibilit!H
gw)ui!I<..1 9QR?/0H
#n!na&I<..1 DA0A<:H
secgrouIsec'roupH
to!irItopdirH
language?1
eulre#i$IeulprefixH
iasho&eIias#omeH
Leult)eIeult!peHM
L&o!eImodeHM
L!riverIdriverHM
L#ilelistIfilelistHM
Llog#ileIlo'fileHM
Lar#ileIparfileHM
Q#ere4
Para&eter Descrition
secgrou <..1 responsibilit! securit! 'roup
to!ir ;op level director! w#ere 0iscoverer files are available
iasho&e 6racle <pplication 1erver 10' + Business /ntelli'ence 10' 6racle Come director!
eulre#i$
,?8 sc#ema prefix. Dor example7 use eulre#i$GEU< for sc#ema ,?8_?1
eult)e O<TP ) default7 for standard <pplications 11i 0iscoverer content
ED@ ) for ,nterprise 0ata Qare#ouse 0iscoverer content
?se eult)eGO<TP to import t#e 0iscoverer 10.1.2 content for 6racle ,)
Business 1uite -elease 11i
&o!e (O0P<ETE ) import all 0iscoverer content.
D/8;E/ ) default7 import specific subset of files
A8<E<8ST ) import specific subset of files
Dor t#e initial full import of t#e 0iscoverer 10.1.2 baseline files delivered b!
patc# 18(41%1 7 use&o!eGco&lete. ;#is mode will upload all .eex files
3Xo.eex5 from t#e ...+discover+ director!into t#e 0iscoverer ,nd ?ser 8a!er.
!river 1pecifies a comma)separated list of driver files to be loaded. ;#is parameter is
re"uired if&o!eGD/8;E/
#ilelist 1pecifies t#e filename of a file containin' a list of files to be loaded. ;#is
parameter is re"uired if&o!eGA8<E<8ST
log#ile 8o' file w#ere t#e adupdeul.s# script lo's t#e result of t#e import process.
0efault filename isa!u!eul.log
ar#ile Dilename of a command)line parameter file containin' entries of t#e
form P"/"0ETE/G;"<UE..arameters specified at t#e command line take
precedence over t#ose specified in t#e parameter file.
6otes4
<ll parameters must be specified on a sin'le command line or in a parameter file. Aame)value
pairs must not contain spaces. Dor example4
P"/"0ETE/G;"<UE is acceptable
P"/"0ETE/ G ;"<UE will 'enerate errors
,xample4
:ount or cop! t#e director! *<?_;6.+discover as +user1+au_top+discover
cd +user1+au_top+discover 3w#ere adupdeul.s# is located5
1tart t#e full import of all .eex files in topdir+?17 w#ere topdir is specified as a parameter
s# adupdeul.s# J
connects!sadmin+s!sadmin)passwordPdb J
respT1!stem <dministratorT J
'w!uid<..81R1.?B+.?B J
fndnam<..1 J
sec'roupT1tandardT J
topdir+user1+au_top+discover J
lan'ua'e?1 J
eulprefix,?8 J
eult!pe68;. J
modecomplete J
ias#ome+oracle+i<1+bi J
lo'fileimport_complete_eul_us_cust11&.lo'
;#e above example is displa!ed on multiple lines for clarit!O do not t!pe t#e backslas#.
2.'. .erformance of t#e import process 'reatl! depends on network latenc! between t#e 6racle Business /ntelli'ence
10' node and t#e database7 and on available resources on !our 6racle Business /ntelli'ence 10' node. 0ependin' on
t#ese factors7 t#e import process ma! take less t#an one #our or up to several #ours to complete for t#e entire set of
0iscoverer baseline .eex files. ;o minimiNe over#ead from network latenc! durin' t#e import process7 it is stron'l!
recommended t#at 6racle Business /ntelli'ence 10' be installed on a mac#ine t#at is close to t#e database server and
#as a fast network connection.
2.5. 2#eck t#e lo'file after import. ;#is s#ould be a clean import lo'file. Rou s#ould be able to see t#at t#e import
utilit! exited wit# status 0 and t#e lo'file contains t#e messa'e I&port co&pleted successfull%.
Rou can safel! i'nore t#e followin' messa'es in t#e import lo'4
)topdir*+)language*+)file*.ee(, -!e i&port process did not i&port or &odif% an% data
;#is messa'es provides information t#at IfileH.eex is an empt! obsolete file and does not modif! an! data durin'
import.
)topdir*+)language*+)file*.ee(, -!e identifier for ... contains one or &ore of t!e c!aracters . / 0 1 ( ) 2 !ic! ill
3e de0supported for use in identifiers in future releases of Discoverer 0 see release notes for &ore details.
Rou can safel! i'nore t#is messa'e usin' 0iscoverer 10.1.2. 1ee release notes for more details.
2.3. <s -elease 11i products continuall! update and improve support for 0iscoverer in subse"uent releases7 it will
be necessar! to install additional 0iscoverer loader files after t#is initial installation. .lease refer to 1ection $ for
details on importin' subse"uent patc#es usin' modedriver.
Ste 4. /e#resh the Discoverer 10.1.2 En! User <a)er
<fter t#e 0iscoverer 10.1.2 content for -elease 11i #as been imported into t#e 0iscoverer ,nd ?ser 8a!er on t#e
database tier7 t#e ,nd ?ser 8a!er must be refres#ed a'ainst t#e -elease 11i data model. ;#is ensures t#at all
references between business areas7 folders7 workbooks7 business views7 flexfields7 and -elease 11i database obEects
are valid.
6n ?nix platforms !ou ma! run t#e refres# process on t#e standalone application server w#ere 6racle Business
/ntelli'ence 1erver 10' -elease 2 was installed.
<lternativel! on Qindows platforms !ou ma! run t#e refres# process on t#e mac#ine w#ere 0iscoverer
<dministration ,dition is installed.
4.1. :ove to t#e ... +discover+ director! w#ere adrfseul.s# is located.
4.2. 1tart t#e refres# process a'ainst t#e database usin' t#e s#ell script adrfseul.s#.
1!ntax for t#e adrfseul.s# script4
W s# adrfseul.s#
connectI<..1 admin userH+IpasswordHPItwotaskH
resI<..1 administrator responsibilit!H
gw)ui!I<..1 9QR?/0H
#n!na&I<..1 DA0A<:H
secgrouI<..1 securit! 'roupH
eulsche&aIeul sc#emaH
eulasswor!IeulpasswordH
twotaskItwotaskH
iasho&eIias#omeH
Llog#ileIlo'fileHM
Lar#ileIparfileHM
Q#ere4
Para&eter Descrition
eulsche&a
Dull ,?8 sc#ema name7 for example eulsche&aGEU<9US
eulasswor! ,?8 sc#ema password
twotask 0atabase name as specified in !our tnsnames.ora file
iasho&e 6racle <pplication 1erver 10' + Business /ntelli'ence 10' 6racle Come
director!
log#ile 8o' file w#ere t#e adupdeul.s# script lo's t#e result of t#e import process.
0efault filename is a!r#seul.log
ar#ile Dilename of a command)line parameter file containin' entries of t#e
formP"/"0ETE/G;"<UE. .arameters specified at t#e command line take
precedence over t#ose specified in t#e parameter file.
6otes4
<ll parameters must be specified on a sin'le command line or in a parameter file. Aame)value
pairs must not contain spaces. Dor example4
P"/"0ETE/G;"<UE is acceptable
P"/"0ETE/ G ;"<UE will 'enerate errors
,xample4
cd +user1+au_top+discover 3w#ere adrfseul.s# is located5
1tart t#e refres# process of all existin' eul folders a'ainst t#e database
s# adrfseul.s# J
connects!sadmin+s!sadmin)passwordPm!db J
respT1!stem <dministratorT J
'w!uid<..81R1.?B+.?B J
fndnam<..1 J
sec'roupT1tandardT J
eulsc#ema,?8_?1 J
eulpassword,?812( J
twotaskm!db J
ias#ome+oracle+i<1+bi J
lo'filerefres#_eul_us_m!db.lo'
;#e above example is displa!ed on multiple lines for clarit!O do not t!pe t#e backslas#.
@arning
Dor t#e refres# process !ou must use t#e <pplications ?ser+-esponsibilit!
1R1<0:/A41!stem <dministrator to lo'on rat#er t#an t#e ,nd ?ser 8a!er database sc#ema
owner. ;#e ,nd ?ser 8a!er database sc#ema owner doesnKt #ave t#e necessar! 'rants for t#e
<..1 sc#ema and t#e refres# process would drop 0iscoverer foldersZ ?sin' adrfseul.s# for
t#e refres# enforces usin' <pplications ?ser+-esponsibilit! in t#e connect strin'.
Dor all Business <reas expect several #ours for t#e refres# process to complete7 dependin' on !our flex structure.
Rour ,nd ?ser 8a!er is now refres#ed. Dlex columns #ave been pulled in to t#e folders usin' t#e flex prompts in t#e
lan'ua'e of t#e ,nd ?ser 8a!er as /tem 0ispla! Aames.
Ste D. Crant "ccess to /esonsi-ilities7 Users7 an! @ork-ooks 3optional5
/ndividual 0iscoverer users ma! be 'ranted access to specific -elease 11i responsibilities7 w#ic# in turn provide
access to 0iscoverer business areas and workbooks. ,it#er t#e 0iscoverer 10.1.2 eulapi command)line utilit! or
0iscoverer 10.1.2 <dministration ,dition can be used to associate business area access wit# -elease 11i
responsibilities7 and to identif! workbook access privile'es for responsibilities and users.
;#e procedures described in t#is step ma! be used as 'uidelines for plannin' !our 0iscoverer reportin' securit!.
Rour 0iscoverer reportin' strate'! ma! be defined to reflect !our corporate data securit! strate'!7 policies7 and
business re"uirements. 0iscoverer securit! is flexible and #i'#l! 'ranular7 and !ou ma! wis# to provide broader
access for specific individuals w#o need to be able to see data enterprise)wide7 i.e. across or'aniNational boundaries.
,xample4 Rou ma! wis# some Dinancial anal!sts to #ave access to all of t#e Dinancials /ntelli'ence business areas7
suc# as t#e <ccounts .a!ables and <ccounts -eceivables. ;o do t#is7 'rant access to all of t#e Dinancials /ntelli'ence
business areas to t#e Dinancials /ntelli'ence responsibilit!. ;#e Dinancials /ntelli'ence responsibilit! ma! t#en be
'ranted to t#e individual Dinancial anal!sts w#o s#ould #ave access to t#ose areas.
6ote
/f !ou #ave up'raded to t#e 6racle <pplications 11.&.8 :aintenance .ack or later
:aintenance .ack releases7 !ou can skip t#is step.
;#e 11.&.8 :aintainance .ack and later :aintenance .ack releases alread! include all
necessar! securit! 'rants and workbook s#arin' for t#e pre)seeded 6racle <pplications
responsibilities. /f !ou wis# to 'rant securit! access for Business <reas to 6racle <pplication
users and responsibilities in addition to t#e 'rants t#at are provided wit# t#e 11.&.8
:aintenance .ack and #i'#er7 !ou ma! optionall! follow t#e procedures listed in t#is step.
D.1 Crant Privileges7 Securit) an! @ork-ook "ccess on Uni$
Dor information about delivered Business <reas wit# 6racle ,)Business /ntelli'ence 1uite please refer to C!apter 4
of t!e Oracle Business Intelligence $%ste& I&ple&entation Guide . Rou must 'rant securit! access to t#e 6racle
<pplications responsibilities !ou would like to use for eac# Business <rea.
Rou ma! use t#e 0iscoverer 10.1.2 eulapi command line utilit! on t#e standalone application server w#ere 6racle
Business /ntelli'ence 1erver 10' -elease 2 was installed in 1tep 1 to 'rant privile'es7 business area securit! and
workbook access.
Dor #elp on usa'e of t#e eulapi command)line utilit!7 t!pe4
*6-<28,_C6:,+bin+eulapi )#elp 'rant_privile'e
,xample 14
9rant 0iscoverer ?ser privile'es to responsibilit! TDinancials /ntelli'enceT
*6-<28,_C6:,+bin+eulapi J
)26AA,2; I,?8 sc#emaH+IpasswordHPIdbH J
)9-<A;_.-/F/8,9, J
)-68, TDinancials /ntelli'enceT J
).-/F/8,9, all_user_privs
,xample 24
9rant securit! access for business area T9eneral 8ed'erT to responsibilit! TDinancials /ntelli'enceT
*6-<28,_C6:,+bin+eulapi
)26AA,2; I,?8 sc#emaH+IpasswordHPIdbH J
)9-<A;_.-/F/8,9, J
)-68, TDinancials /ntelli'enceT J
)B?1/A,11_<-,<_<22,11 T9eneral 8ed'erT
D.2. Crant Securit) an! Privileges using Discoverer "!&inistration E!ition on @in!ows
/f !ou #ave alread! 'ranted securit! and privile'es usin' t#e 0iscoverer 10.1.2 eulapi command)line utilit!7 !ou ma!
skip t#is step.
8o' in to t#e 0iscoverer <dministration ,dition 10.1.2 as t#e <pplications ?ser w#ic# was 'ranted full
<dministration .rivile'es and 1ecurit!4
I6racleComeHJbinJdis&adm.exe +26AA,2; T1R1<0:/A41!stem <dministrator+IpasswordHPIdbHT +,?8
I,?8prefixH_I8an'H
?se t#e Celp )H <bout 0iscoverer... dialo' to make sure !ou are connected to t#e correct ,nd ?ser 8a!er
3I,?8prefixH_I8an'HO compare t#e import options used above5. Rou can c#an'e t#e ,?8 in t#e dialo' ;ools )H
6ptions )H 0efault ,?8.
?sin' ;ools )H .rivile'es
2#eck T0esktop and .lus .rivile'eT privile'es for all <pplications ?sers and -esponsibilities w#o s#ould be allowed
to open workbooks.
?sin' ;ools )H 1ecurit!
9rant Business <rea access to <pplications ?sers and -esponsibilities w#o s#ould be allowed to "uer! t#e various
Business <reas.
D.' Share @ork-ooks using Discoverer Plus E!ition
Rou must 'rant s#ared workbook access to t#e 6racle <pplications responsibilities to be used for workbook anal!sis.
8o' in to t#e 0iscoverer ?ser ,dition 10.1.2 as t#e <pplications <dministration user w#o imported t#e eex files
in 1ection 67 1tep %.
I6racleComeHJbinJdis&usr.exe +<..1_?1,- +26AA,2; T1R1<0:/A41!stem
<dministrator+IpasswordHPIdbHT +,?8 I,?8prefixH_I8an'H
?se t#e Celp )H <bout 0iscoverer... dialo' to confirm t#at !ou are connected to t#e correct ,nd ?ser 8a!er
3I,?8prefixH_I8an'HO compare t#e import options used in above5. Rou can c#an'e t#e ,nd ?ser 8a!er in t#e
dialo' ;ools )H 6ptions )H 0efault ,?8.
?sin' t#e Dile )H :ana'e Qorkbooks... )H 1#arin'... dialo'
1#are t#e workbooks to t#e <pplications ?sers and -esponsibilities t#at s#ould be allowed to open t#e various
workbooks.
D.5. Test Discoverer /esonsi-ilities an! @ork-ooks
8o' in to 6racle ,)Business 1uite -elease 11i wit# a userid t#at #as been 'ranted one of t#e responsibilities defined
above.
6pen t#e -elease 11 workbooks assi'ned to t#at responsibilit! and verif! t#at t#e! can retrieve and displa! data.
-epeat for eac# responsibilit! t#at #as been defined.
(ongratulationsH
Rou #ave completed !our 0iscoverer 10.1.2 implementation and !our 0iscoverer content for
6racle ,)Business 1uite -elease 11i is read! for use.
/e#erence:
1ubEect4Using Discoverer 10.1.2 with Oracle E-Business Suite 11i
Doc ID4'1'514.1 ;!pe4@>8TE P"PE/
:odified 0ate 423-0"B-200D 1tatus4PUB<8S>ED