. . . . . . . . . .

. . . . . . . . . .

Deploying Webutil on Developer suite

Goal:

This document will explain how to deploy webutil version 1.0.6 on Oracle Developer Suite 10g Release 2 or Application server 10g Release 2.

Steps:

Webutil Version 1.0.6 Download Link:

http://www.oracle.com/technology/software/products/forms/files/webutil/webutil_106.zip

WebUtil Prerequisites:

1. JInitiator 1.3.1.9 and higher.2. An installation of Java 2 SDK, Standard Edition 1.3.1.3. The JACOB libraries from http://prdownloads.sourceforge.net/jacob-project/jacob_18.zip.

WebUtil Installation steps:

Note: When you extract the folder webutil_106 for example in c:\, you will notice that it has 4 folders:Doc, Java, server and webutil.

1. Copy webutil.pll and webutil.olb from the following directory: c:\webutil_106 to oraclehome\forms

2. Check that there is a folder of the name webutil under the path oraclehome\forms, if it doesn’t exist Copy a the folder webutil that exists under the extracted webutil_106 folder to C:\oracle home\forms

note: this folder has 4 files:JNIsharedstubs.dlld2kwut60.dllwebutil_sign.batsign_webutil.sh

3. Run the the script supplied in the directory: c:\webutil_106 to create the package WEBUTIL_DB called "create_webutil_db.sql".

4. From the Jacob zip file , extract Jacob.dll into oraclehome\forms\webutil and Jacob.jar into the oraclehome\forms\java.

5. Move frmwebutil.jar from c:\webutil_106\java to oraclehome\forms\java

6. Move the three html files webutiljini.htm, webutiljpi.htm, webutilbase.htm exist in the directory: webutil_106\webutil_106\server to oraclehome\forms\server.

7. To sign the frmwebutil.jar and Jacob.jar files with the same jar key, create a text document with name issue and change its extension to .bat and then right click on it and choose edit and write the following commands and save:

SETLOCALSET DN_CN=Product ManagementSET DN_OU=Development Tools

SET DN_O=OracleSET DN_C=USSET KEYSTORE="%HOME%/.keystore"SET KEYSTORE_PASSWORD=webutilpasswdSET JAR_KEY=webutil2SET JAR_KEY_PASSWORD=webutil2SET VALIDDAYS=360C:\Oracle home\jdk\bin\keytool -genkey -dname "CN=%DN_CN%, OU=%DN_OU%, O=%DN_O%, C=%DN_C%" -alias %JAR_KEY% -keypass %JAR_KEY_PASSWORD% -keystore %KEYSTORE% -storepass %KEYSTORE_PASSWORD% -validity %VALIDDAYS%C:\ Oracle home\jdk\bin\jarsigner -keystore %KEYSTORE% -storepass %KEYSTORE_PASSWORD% -keypass %JAR_KEY_PASSWORD% C:\Oracle home\forms\java\frmwebutil.jar %JAR_KEY%C:\Oracle home\jdk\bin\jarsigner -keystore %KEYSTORE% -storepass %KEYSTORE_PASSWORD% -keypass %JAR_KEY_PASSWORD% C:\Oracle home\forms\java\jacob.jar %JAR_KEY%ECHO ..end

8. Open the cmd then run the previous batch.

9. Check that the following line is in the file C:\Oracle home\j2ee\DevSuite\application-deployments\forms\formsweb\orion-web.xml: <virtual-directory virtual-path="/webutil" real-path="<ORACLE_HOME>/forms/webutil" />

10. Required configuration in C:\Oracle home\forms\server\ fromsweb.cfg file:

In the [default] section of the fromsweb.cfg file change the archive_jini and archive to the following:# Forms applet archive setting for JInitiatorarchive_jini=frmall_jinit.jar,frmwebutil.jar,jacob.jar

# Forms applet archive setting for other clients (Sun Java Plugin, Appletviewer, etc)archive=frmall.jar

Write the following section at the end of the fromsweb.cfg file:[webutil]WebUtilLogging=offWebUtilLoggingDetail=normalWebUtilErrorMode=AlertWebUtilDispatchMonitorInterval=5WebUtilTrustInternal=trueWebUtilMaxTransferSize=16384baseHTMLjinitiator=webutiljini.htmbaseHTMLjpi=webutiljpi.htmbaseHTML=webutilbase.htmarchive_jini=frmall_jinit.jarWebUtilArchive=frmwebutil.jar,jacob.jar,frmall.jararchive=frmwebutil.jar,frmall.jarlookAndFeel=oracle

11. Required configuration in C:\Oracle home\forms\server\default.env file:Check the following variables to ensure that they have these values:

FORMS_PATH=C:\Oracle home\forms;C:\ Oracle home \forms\webutilWEBUTIL_CONFIG=C:\Oracle home\forms\server\webutil.cfgPATH=C:\Oracle home\bin;C:\Oracle home\jdk\jre\bin\clientCLASSPATH=C:\Oracle home\forms\java\frmwebutil.jar;C:\Oracle home\forms\java\jacob.jar;C:\Oracle home\jdk\jre\lib\rt.jar;C:\Oracle home\forms\java\frmall.jar

12. Required configuration in C:\Oracle home\forms\server\webutil.cfg file:

Add the following two line at the end of the webutil.cfg file:transfer.database.enabled=TRUEtransfer.appsrv.enabled=TRUE

13. Required configuration in enviroment variables:

Make the following environment variables:

webutil_config = C:\oracle home\forms\server\webutil.cfgclasspath = c:\oracle home\forms\java\frmwebutil.jar;c:\oracle home \forms\java\jacob.jar;C:\ oracle home\jdk\jre\lib\rt.jar;C:\oracle home\forms\java\frmall.jar

Check that the following paths exist in the PATH environment variable and if not append them:

C:\oracle home\jdk\bin;C:\oracle home\jdk\jre\bin\classic;C:\oracle home\jdk\jre\bin; C:\oracle home\jdk\jre\bin\client;C:\oracle home\jlib;C:\oracle home\bin;C:\oracle home\jre\1.4.2\bin\client;C:\oracle home\jre\1.4.2\bin

14. Required configuration in the regedit variables:

Run the regedit and check the following variables under the oracle home to ensure that the have these values:

FORMS=c:\oracle home\forms

Note: the following step is not applicable on Application server, it is just applicable on IDS:

FORMS_BUILDER_CLASSPATH=c:\oracle home\forms\java\frmbld.jar;c:\oracle home\jlib\importer.jar;c:\oracle home\jlib\debugger.jar;c:\oracle home\jlib\utj.jar;c:\oracle home\jlib\dfc.jar;c:\oracle home\jlib\help4.jar;c:\oracle home\jlib\oracle_ice.jar;c:\oracle home\jlib\jewt4.jar;c:\oracle home\jlib\ewt3.jar;c:\oracle home\jlib\share.jar;c:\oracle home\forms\java\frmwebutil.jar;c:\oracle home\forms\java\frmall.jar;FORMS_PATH=c:\oracle home\forms;C:\oracle home\forms\webutil;C:\oracle home\cgenf61\ADMIN