Oracle Application Server 10g Release 2 (10.1.

2)
on

SUSE LINUX Enterprise Server 9

!ttp"##$$$.novell.co%#oracle

Arun Sin ! Novell Inc.

Introduction
Oracle Application Server is supporte& an& certi'ie& on SUSE LINUX Enterprise Server. (isit Oracle )etaLin* (!ttp"##%etalin*.oracle.co%) 'or %ore &etails on certi'ications. +!is &ocu%ent is provi&e& to et ,ou starte& $it! Oracle Application Server -.2EE an& /e0 1ac!e- %i&&le tier $it! orarun. Oracle !as provi&e& e2cellenet &ocu%ents3 please consult t!e% 'or ot!er a&&4on pro&ucts li*e Oracle AS In'rastructure3 5ortal an& /ireless3 etc.. 6our 'ee&0ac* is al$a,s $elco%e (arun.sin !7novell.co%). 5lease post ,our 8uestions on SUSE4Oracle 'oru% (suse4oracle7suse.co%).

1. Hardware Requirements
1!ec* t!at ,our co%puter %eets t!e 'ollo$in &is* space an& %e%or, re8uire%ents" J2EE and Web Cache 912 ): =00 ): ?00 ): 1.9 ;: OracleA In!rastructure 1 ;: >.> ;: ?00 ): 1.9 ;:

Item )e%or, <is* space Space in #t%p S$ap space

Portal and Wireless 1 ;: 1.10 ;: ?00 ): 1.9 ;:

1. +o &eter%ine 5!,sical RA) " @ rep )e%+otal #proc#%e%in'o 2. +o &eter%ine availa0le s$ap space" @ rep S$ap+otal #proc#%e%in'o

2. O Requirements
Oracle Application Server 10g Release 2 (10.1.2) !as 0een certi'ie& to run on s,ste%s runnin SUSE LINUX Enterprise Server 9 (SLES 9). Evaluation So't$are can 0e &o$nloa&e& 'ro% respective $e0 sites. 1. Novell SUSE Linu2 Enterprise Server 9 $it! latest Service 5ac*s (!ttp"##$$$.novell.co%#pro&ucts#linu2enterpriseserver#eval.!t%l) 2. Oracle Application Server 10 R2 (10.1.2) 4 Oracle Application Server .2EE an& /e0 1ac!e (asAlinu2A2BCAcoreA101200.cpio)

".Installation te#s
1. Install $ E %I&$' Enter#rise er(er )
I' ,ou !ave ,our SLES9 server pre4installe&3 Dust ensure ,ou !ave re8uire& pac*a es installe&. Ot!er$ise3 'ollo$ Installation steps provi&e& in SUSE LINUX Enterprise Server 9 %anual. )a*e sure -1#1EE 1o%piler an& +oolsan& ot!er re8uire& pac*a es are installe& i.e. &013 s,sstat3 etc. a. Check that SUSE LINUX Enterprise Server 9 is installed:
@cat #etc#SuSE4release SUSE LINUX Enterprise Server 9 (i9BC) (ERSION F 9

b. The minimum supported kernel versions is: kernel .!."#$.9$ %uname #r c. Check that the &ollo'in( so&t'are packa(es) or hi(her versions) are installed: % rpm #* packa(e+name
glibc-2.3.3-98.28 gcc-3.3.3-43.24 gcc-c++-3.3.3-43.24 libstdc++-3.3.3-43.24 libstdc++-devel-3.3.3-43.24 openmotif21-libs-2.1.30MLI4-119.1 pdksh-5.2.14- 80.1 m!ke-3.80-184.1 gnome-libs-1.4.1. -" 1.1 gnome-libs-devel-1.4.1. -" 1.1 s#sst!t-5.0.1-35.1 bin$tils-2.15.90.0.1.1-32.5 db1-1.85-85.1 comp!t-2004. .1-1.2

d. libdb.so. : I& this &iles is not there then create &ollo'in( s,mbolic link or install db- packa(e.
@ln 4s #usr#li0#li0&0.so.> #usr#li0#li0&0.so.2

e. .etc.hosts: /lease comment out I/v! addresses &or localhost

)a*e sure t!at t!e local!ost entr, in t!e #etc#!osts 'ile is an I5v? entr,. I' t!e I5 entr, 'or local!ost is I5vC 'or%at3 installation cannot succee&. +!e 'ollo$in e2a%ple s!o$s

%o&i'ie& local!ost entr," @ special I5vC a&&resses @ ""1 local!ost ipvC4local!ost ipvC4loop0ac*

Oracle provi&es perl script (patc! ?0190?9) to 'i2 a0ove entries. +!ese patc!es are availa0le 'ro% !ttp"##%etalin*.oracle.co%

&. .etc.services: 0ake sure that the &ollo'in( port ran(es are available
1. 5orts 1B1241B29 re8uire& 'or Oracle Enterprise )ana er (console) 2. 5orts 1B>041B?9 re8uire& 'or Oracle Enterprise )ana er (a ent) >. 5orts 1B9041BC9 re8uire& 'or Oracle Enterprise )ana er (R)I) ?. 5orts >0C04>129 re8uire& 'or Oracle Internet <irector, 9. 5orts >1>04>199 re8uire& 'or Oracle Internet <irector, (SSL) I' t!ese ports are not availa0le3 t!e associate& con'i uration assistants $ill 'ail &urin t!e installation. I' necessar,3 re%ove entries 'ro% t!e -#etc#services- 'ile an& re0oot t!e s,ste%. Oracle provi&es perl script (patc! >1C=92B) to re%ove t!ese entries.

2. Install orarun
SUSE provi&es orarun pac*a e to auto%ate %ost o' t!e Oracle pre4install tas*. Re'er to Oracle installation &ocu%ent 'or co%plete list o' prere8uisites3 I' ,ou c!oose to &o on ,our o$n. 1. Install orarun pac*a e 'or SLES 9. 6ou can &o$nloa& latest version o' orarun 'ro% !ttp"##'tp.novell.co%#partners#oracle#sles49#. 6ou can use 6aS+ (#s0in#,ast2) setup tool or install %anuall, usin rp%. @rp% 4i #%e&ia#c&ro%#suse#i9BC#orarun41.B4109.9.i9BC.rp% 2. +!e account 'or GoracleH user is &isa0le&. 1. Ena0le it3 0, c!an in t!e s!ell 'or t!e -oracle- user 'ro% -#0in#'alseto -#0in#0as!-3 0, e&itin t!e 'ile -#etc#pass$&-. 2. Set a ne$ pass$or& 'or user GoracleH i.e. G#usr#0in#pass$& oracleH. >. Run G#usr#s0in#rcoracle start G to set *ernel para%eters. 1. A'ter installin t!e orarun pac*a e3 co%plete t!e 'ollo$in steps to reset t!e environ%ent 'or Oracle Application Server"

1. I' an, .ava pac*a es are installe& on t!e s,ste%3 unset t!e .ava environ%ent varia0les .A(AAIO)E. Oracle Application Server installs an& uses its o$n .ava pac*a es. Jollo$in $ill &isa0le Dava at 0oot ti%e on ,our server"
@ %v #etc#pro'ile.&#allDava.s! #etc#pro'ile.&#allDava.s!.0a*

. E&it *etc*#ro!ile.d*oracle.sh 'ile to set#unset 'ollo$in environ%ent varia0les" a) 1o%%an& to unset .A(A an& ot!er environ%ent varia0les" -unset .A(AAIO)E +NSAA<)IN ORAANLS>>0) Set proper ORA1LEAIO)E3 ORA1LEASI<. Un'ortunatel, AS &oesnKt uses t!ese 0ut ,ou s!oul& set it correct an,$a,s. c) Set environ%ent varia0le +)5 i.e. e2port +)5F#t%p

". Install Oracle A##lication er(er 1+g R2,1+.1.21. )a*e sure ,ou are lo e& in as GoracleH user.

2. ;et Oracle Application Server 10 R2 (10.1.2) So't$are 'ro% oracle $e0 or use ,our Oracle <is*s. >. Run Oracle Universal Installer" L .#runInstaller

Note" I' ,ou start runInstaller 'ro% <is*1 t!en it $ill co%plain a0out oracle.s! 'ile. I nore t!is or start runInstaller 'ro% <is*1#install. Jollo$in $elco%e screen $ill appear an& 'ollo$ &irections care'ull,.

I& this is the &irst 2racle product to be installed on this computer) the installer displa,s these additional screens:

Specify File Locations:

Product-specific Prerequisite Checks: 3 'arnin( is displa,ed i& the s,stem does not meet the re*uirements. I& ,ou need to chan(e a kernel parameter) e4it the installer and start the installation a(ain.

M i(nore openmoti& 'arnin(. SLES9 comes 'ith latest version.

Confirm Pre-Installation Requirements:

Select components you would like to Install:

Specify Port Configuration

ptions: Select 3utomatic

racle!S Instance "ame and ias#admin Password: Instance "ame: Enter a name &or this instance. Instance names can contain alphanumeric and + 5underscore6 characters. I& ,ou have more than one 2racle 3pplication Server instance on a computer) the instance names must be uni*ue. E4ample: %2&& ias#admin Password and Confirm Password: Enter and con&irm the pass'ord &or the ias+admin user. This is the administrative user &or this instance. /ass'ords must consist o& at least &ive characters) and one o& the characters must be a number.

Summary: 7eri&, ,our selections and click Install.

Run root$sh dialog: In a di&&erent 'indo') lo( in as the root user and run the 'oot.sh script. 3&ter ,ou have run the 'oot.sh script) click 28.

Configuration !ssistants: This screen displa,s the pro(ress o& con&i(uration assistants. Con&i(uration assistants con&i(ure 2racle 3pplication Server components.

%nd of Installation: Click %&ist$

.. Oracle Enter#rise /ana0er A##lication er(er Control

I' iasconsole services is not starte&3 t!en start it %anuall, 0, enterin 'ollo$in co%%an& Ge%ctl start iasconsoleH.

Use a 0ro$ser to &o routine Application Server a&%inistration tas*s via $e0 inter'ace. URL" !ttp"##I5AA&&ress"1B12#

1. Oracle A##lication er(er Automatic tartu#* hutdown

+!is section e2plains !o$ to %a*e Oracle Application Server start an& stop auto%aticall, &urin server startup an& s!ut&o$n on SUSE Linu2. 1. Lo in as a root user an& create a 'ile calle& -#etc#init.&#ias- . Sa%ple 'ile is provi&e& !ere. 2. Use c!%o& co%%an& to set t!e privile es to =90"
chmod( 50()etc)init.d)i!s

>. A&& root user to t!e -&0a an& oinstall- roups to allo$ t!e script to 'unction correctl,. ?. Use -c!*con'i - to ena0le#&is0ale ias script or create lin* %anuall, to appropriare run4level. i.e. c!*con'i ias on Note" I' ,ou are e2pert in scrptin 3 ,ou can %er e a0ove instrucstions to e2istin oracle script (#etc#init.&#oracle).

am#le cri#t ,ias-2

@N #0in#s! @ @ Aut!or " Arun Sin !3 Novell Inc. @ @ 1. A&& root to &0a an& oinstall roup to 'unction t!is script properl, @ @ 2. 1reate t!is 'ile in #etc#init.& &irector, (ias) an& use -c!*con'i ias on@ 6ou can put t!ese an& ot!er co%%an&s in a sin le 'ile (startup or s!ut&o$n) @ an& use as sin le co%%an&. +!is e2a%ple is to %a*e instruction clear. @ LORA1LEAIO)E#&c%#0in#&c%ctl startup @ LORA1LEAIO)E#op%n#0in#op%nctl start @ LORA1LEAIO)E#0in#e%ctl start iasconsole @ @@@ :E;IN INI+ INJO @ 5rovi&es" ias @ Re8uire&4Start" Lnet$or* Ls,slo Lre%oteA's ra$ @ Re8uire&4Stop" @ <e'ault4Start" > 9 @ <e'ault4Stop" 0 1 2 C @ <escription" Start t!e Oracle iAS @@@ EN< INI+ INJO ORA1LEA:ASEF#opt#oracle ORA1LEAIO)EFLORA1LEA:ASE#oracleas ORAAO/NERForacle ...

... case -L1- in start) ec!o 4n -Satrin Oracle iASsu 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#&c%#0in#&c%ctl start- O su 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#op%n#0in#op%nctl startall- O su 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#0in#e%ctl start iasconsole- O PP stop) ec!o 4n -Stoppin Oracle iASsu 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#&c%#0in#&c%ctl s!ut&o$n- O su 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#op%n#0in#op%nctl stopall- O su 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#0in#e%ctl stop iasconsole- O PP status) ec!o 4n -1!ec*in 'or Oracle iASsu 4 LORAAO/NER 44co%%an&F-LORA1LEAIO)E#0in#e%ctl status iasconsole- O PP M) ec!o -Usa e" L0 QstartRstopRstatusSe2it 1 esac

3. Chan0in0 4ernel Parameters

I' ,ou are usin orarun t!en reco%%en&e& values are set. 6ou can c!an e an& veri', usin 6aS+ (.sbin.,ast #9S,stem#9.etc.s,scon&i( Editor #9/roductivit,# 9:atabases#9Tools#92racle#9S,stem). I' ,ou $ant to c!an e t!e value o' *ernel para%eter not provi&e& 0, orarun3 t!en co%plete t!e 'ollo$in steps" a. Usin an, te2t e&itor3 create or e&it t!e #etc#s,sctl.con' 'ile an& a&& ne$ *ernel para%eter values. Jor e2a%ple %essa e 8ueues *ernel para%eter $ill loo*s li*e"
ke'nel.msgmni(*(28 8(+n$mbe'(of(mess!ges, ke'nel.msgm!-(*(8192(+m!-(no(of(b#tes(pe'(mess!ge, ke'nel.msgmnb(*("5535(+tot!l(si.e(of(the(/$e$e,

:, speci',in t!e values in t!e #etc#s,sctl.con' 'ile3 t!e, persist $!en ,ou re0oot t!e s,ste%. 0. Enter t!e 'ollo$in co%%an& to c!an e t!e current values o' t!e *ernel para%eters.

@ #s0in#s,sctl 4p c. Enter t!e 'ollo$in co%%an& to %a*e t!e s,ste% rea& t!e #etc#s,sctl.con' 'ile $!en it re0oots" @ c!*con'i 0oot.s,sctl on &. +o vie$ current values o' *ernel para%eters" @#s0in#s,sctl 4a

.. 4nown Issues 5 Wor6around

1. O1?. " <1) Error 4 #usr#li0#li0&0.so.2 is %issin . Install &01 pac*a e or create so't lin* 'or #usr#li0#li0&0.so.2 . O1?." ;ava.net.ConnectE4ception: Connection re&used 1!ec* #etc#!osts 'ile 'or I5vC entries. >. E)C?+#A)<C?" co%%ent out 'ollo$in lines 'ro% # etc#pro'ile.&#oracle.s!
@test 4& #li0#iCBC OO e2port L<AASSU)EATERNELF2.?.21 @test 4' #usr#li0#li0InternalS,%0ols.so OO e2port L<A5RELOA<F#usr#li0#li0InternalS,%0ols.so

1. Re!ernces
Oracle Application Server10 Release 2 (10.1.2) <ocu%entation Li0rar, !ttp"##&o$nloa&4$est.oracle.co%#&ocs#c&#:19=90A09#&ocs.!t%

Histor72
'ate <".<".<" Changes Initial :ocument created.

En8o79