2/13/2015

Document Display

HowToInstallWebutilon10.1.2.xOracleApplicationServer(DocID566628.1)
InthisDocument
Goal
Fix

ConfiguringtheWebutilDemoForm(ThelatestversioniscanbedownloadfromthisnoteNote1272222.1)
References

APPLIESTO:
OracleFormsVersion10.1.2to10.1.2.3.0[Release10.1.2to10.1.2.3]
Informationinthisdocumentappliestoanyplatform.
Appliesto10gR2onallplatforms.
Checkedforrelevanceon13MAR2013

GOAL
Checkedforversionaccuracy:07Feb2011
HowtoinstallWebUtilon10.1.2.xApplicationServer.

Note:For11gFormsseeNote1093985.1"HowtoConfigureWebutilinForms11g".

FIX
1.GetthecorrectWebutilversion:
TheWebUtilversionshouldmatchtheversionofForms.Forexample,10.1.2.2shoulduseWebUtil10.1.2.2which
comesfromthe10.1.2.2patch.However,Oraclerecommendsyoubeon10.1.2.3andthelatestbundledpatch
Patch9593176followedbyoverlayPatch11710576whichcontainsthecorrectwebutilversionfor10.1.2.3witha
certificatethatdoesnotexpireuntilJuly2013.
StartingfromOracleForms10.1.2.0.2,WebutilisdeliveredasacomponentofOracleDeveloperSuite10g
(10.1.2.0.2).Thefilefrmwebutil.jarislocatedunderORACLE_HOME/forms/java
1.ByDefaultWebutilisNOTdeliveredasacomponentofOracleApplicationServer(Webutilisdeliveredasa
componentofOracleDeveloperSuiteonly),henceyouneedtogetthecorrectversionofthefrmwebutil.jar
fromanOracleDeveloperSuiteinstallationthatmatchesthesameApplicationServerversion.
Notethatifyouinstallthe10.1.2.3.1BundledpatchPatch9593176followedbypatch11710576thiswill
installthecorrectversionofWebutilfor10.1.2.3
2.Webutil1.0.6isthebasereleaseofWebutil.Webutil1.0.6isavailableforuseonlywithversions9.0.4of
OracleForms.
2.GetthecorrectJacobversion
a.Ifyouareusinganearlierversionof10gR2suchas10.1.2.0.2or10.1.2.2youwilluse:
https://support.oracle.com/epmos/faces/SearchDocDisplay?_adf.ctrl-state=4jfuypijs_9#aref_section21

1/4

2/13/2015

Document Display

JACOB1.8
b.However,ifyouareusingthe10.1.2.3.1BundledPatch<>oranearliercourtesypatch(supermerge)suchas
9282569youmustJacob1.10.1asspecifiedintheReadme.txtfileforthatpatch>Jacob1.10.1
Thereadmeofanycourtesypatch(supermerge)thatrequiresJacob1.10.1willspecifyitsrequirement.
3.Createfolder"webutil"under
%ORACLE_HOME%\forms

4.Copythefollowingfilesinto%ORACLE_HOME%\forms\webutil:
jacob.dll>includedinjacob_18.ziporjacob_1.10.1.zipasapplicable.
d2kwut60.dll>getitfromDeveloperSuiteunder%ORACLE_HOME%\forms\webutil
JNIsharedstubs.dll>getitfromDeveloperSuiteunder%ORACLE_HOME%\forms\webutil
sign_webutil.bat>getitfromDeveloperSuiteunder%ORACLE_HOME%\forms\webutil

5.Copythefollowingfileto%ORACLE_HOME%\forms\java:
jacob.jar(version1.8or1.10.1asapplicable)

NoteifyouinstalledPatch9593176or9282569or11710576youwillnotneedtoaccomplishstep6.Thecorrect
versionforfrmwebutil.jarisinstalledbythesepatches.
6.CopytheWebutilJARfilefrmwebutil.jarfrom%ORACLE_HOME%\forms\javaofdevelopersuiteto
%ORACLE_HOME%\forms\javaoftheapplicationserver.
NOTE:ORACLEDOESNOTRECOMMENDCUSTOMERSUSE10.1.2.02ATTHISTIME.10.1.2.3ISTHE
RECOMMENDEDPATCH
ForForms10.1.2.0.2youwillneedtoapplypatch5017052.Thispatchwilladdthefollowingjavascriptfiles
andwillmodifytheformsbaseHTMLfilestocallthenewJavaScripts.
ORACLE_HOME\java\forms_base_ie.js
ORACLE_HOME\java\forms_ie.js
TheseJavaScriptfilesarerequiredforovercomingtheimpactofMicrosoftpatchKB912945thatcreated
functionalitychangesintheInternetExplorerbrowser.Asthesefilesaremissingyoumightget"WhiteScreen"
whenappletstarted.
7.Signthe"jacob.jar"asfollows:
startthecommandprompt
cd%ORACLE_HOME%\forms\java
setPATH=%ORACLE_HOME%\jdk\bin%PATH%
%ORACLE_HOME%\forms\webutil\sign_webutil.bat%ORACLE_HOME%\forms\java\jacob.jar

8.Ifneeded,copythefollowingfilesfrom%ORACLE_HOME%\forms\serverofthedevelopersuiteto
%ORACLE_HOME%\forms\serveroftheapplicationserver)
webutil.cfg

9.Thefollowingvariablemustbedefinedin%ORACLE_HOME%\forms\server\default.env:
WEBUTIL_CONFIG=<ORACLE_HOME>\forms\server\webutil.cfg

10.ThefollowingjarsmustbeincludedintheCLASSPATHinforms/server/default.env:
https://support.oracle.com/epmos/faces/SearchDocDisplay?_adf.ctrl-state=4jfuypijs_9#aref_section21

2/4

2/13/2015

Document Display

%ORACLE_HOME%\forms\java\frmall.jar%ORACLE_HOME%\forms\java\frmwebutil.jar%ORACLE_HOME%\forms\jav

11.Theconfigurationfileformsweb.cfgshouldhavethefollowingsection:
[webutil]
WebUtilArchive=frmwebutil.jar,jacob.jar
WebUtilLogging=off
WebUtilLoggingDetail=normal
WebUtilErrorMode=Alert
WebUtilDispatchMonitorInterval=5
WebUtilTrustInternal=true
WebUtilMaxTransferSize=16384
baseHTMLjinitiator=webutiljpi.htm
baseHTMLjpi=webutiljpi.htm
archive=frmall.jar
lookAndFeel=oracle

IfyouarecreatingacustomconfigurationsectionforrunningWebUtil,includealloftheparameters
aboveinyourconfigurationsection.Failuretodosowillresultinthefailure:
load:classoracle.forms.webutil.common.RegisterWebUtilnotfound.
Also,thisconfigurationsectionissetuptousetheSUNJREandnotJInitiator.JInitiatorhasbeen
desupported.PleaseseeNote761159.1.

12.Thefollowingvirtualpathmustbedefinedinthe%ORACLE_HOME%\forms\server\forms.conffile:
AliasMatch^/forms/webutil/(..*)"%ORACLE_HOME%/forms/webutil/$1"

ConfiguringtheWebutilDemoForm(ThelatestversioniscanbedownloadfromthisnoteNote
1272222.1)
13.CopytheDLLfileffisamp.dll(includedinWebutil_demo.zip)to
%ORACLE_HOME%\forms\webutil

14.Openwebutil.cfgfileandaddthefollowingline

Addthefollowingline:
install.syslib.0.user.1=ffisamp.dll|40960|1.0|true
below:
install.syslib.0.7.1=jacob.dll|106496|1.10|true
install.syslib.0.9.1=JNIsharedstubs.dll|65582|1.0|true
install.syslib.0.9.2=d2kwut60.dll|192512|1.0|true

Notethatthesizeofjacob.dllwilldifferdependingonwhetheryou'reusingjacob1.8or1.10.1.The
entryaboveisforjacob1.10.1.Theentryforjacob1.8is>install.syslib.0.7.1=jacob.dll|94208|1.0|true
15.Inthewebutil.cfgfileensureyouhavethelines
transfer.appsrv.workAreaRoot=d:\temp
https://support.oracle.com/epmos/faces/SearchDocDisplay?_adf.ctrl-state=4jfuypijs_9#aref_section21

3/4

2/13/2015

Document Display

transfer.appsrv.accessControl=FALSE
transfer.database.enabled=TRUE
transfer.appsrv.enabled=TRUE

16.Createadatabaseuser"Webutil".
17.Runthescript(existsinDeveloperSuiteinstallation)
%ORACLE_HOME%\forms\create_webutil_db.sql

18.Createafilecalledd:\temp\downloaded_from_as.txt.Ensureyouaddtexttothisfile.Thisisatestfilewhich
willbeusedtodemonstrateloadingfilesfromtheapplicationservertotheclient.TheDownloadtestexpectsthisfile
toexistinthislocationontheApplicationServer.
19.Openformsbuilderandconnectas"Webutil"user.CompileALL"(shiftControlK)formwebutil_demo.fmband
webutil.pll,thengeneratethefmxandplxusing(ControlT).
20.Movethefollowingfilesto%ORACLE_HOME%\forms:
webutil_demo.fmx
webutilplx
webutil.olb

21.RuntheDemoformwebutil_demoasthefollowingtomakesurethattheinstallationwentfine:
http://host:port/forms/frmservlet?
config=webutil&form=webutil_demo&userid=webutil/webutil@db

22.Formoreinformation,gothroughthewebutildocumentation(specially"RuntimeSetupChecklist"and
"WebUtilInstallationSteps").Youwillalsofindmoreinformationaboutthevariouswebutilprogramunits:
WebutilDocumentation
23.YoumayalsorunthediagnostictestformdescribedinthefollowingnoteforfurthercheckingontheWebutil
configuration:
Note:553849.1WebutilDiagnosticTestFormForCheckingWebutilConfiguration

REFERENCES
NOTE:1093985.1HowtoConfigureWebutilinForms11g
NOTE:1272222.1WebutilDemoDownloadLocation
NOTE:333385.1KickstartingWebUtil1.06inDeveloperSuite10.1.2.0.2onWindows
NOTE:369106.1"RegisterWebUtilnotfound"ErrorWhenImplementingWebutil
NOTE:374128.1HowToInstallWebutilonOASunderLinux/Unix
NOTE:421930.1HowToGetFRMWEBUTIL.JARFromIAS/IDSPatchset10.1.2.xKit
NOTE:553849.1WebutilDiagnosticTestFormForCheckingWebutilConfiguration

https://support.oracle.com/epmos/faces/SearchDocDisplay?_adf.ctrl-state=4jfuypijs_9#aref_section21

4/4