Vos systèmes Oracle. MODERNISÉS.

Oracle Forms & Reports

Comment installer WebUtil sur Oracle Application Server 10.1.2.x

Patrick Hamou 5 min de lecture

S'APPLIQUE À :

Oracle Forms - Version 10.1.2 à 10.1.2.3.0 [Release 10.1.2 à 10.1.2.3]
Les informations de ce document s'appliquent à toutes les plateformes.
S'applique à la 10gR2 sur toutes les plateformes.
Pertinence vérifiée le 13-MAR-2013
Pertinence vérifiée le 23-Nov-2015

OBJECTIF

Exactitude des versions vérifiée le : 07-Feb-2011

Comment installer WebUtil sur Application Server 10.1.2.x.


Remarque : pour Forms 11g, voir la Note 1093985.1 "How to Configure Webutil in Forms 11g ".

SOLUTION

1. Procurez-vous la bonne version de WebUtil :


La version de WebUtil doit correspondre à celle de Forms. Par exemple, la 10.1.2.2 doit utiliser WebUtil 10.1.2.2, fourni avec le correctif 10.1.2.2. Oracle vous recommande toutefois d'être en 10.1.2.3 avec le dernier correctif groupé (bundled patch) -

Patch 9593176, suivi du correctif complémentaire (overlay) Patch 11710576, qui contient la bonne version de WebUtil pour la 10.1.2.3, avec un certificat qui n'expire qu'en juillet 2013.

À partir d'Oracle Forms 10.1.2.0.2, WebUtil est livré comme composant d'Oracle Developer Suite 10g (10.1.2.0.2). Le fichier frmwebutil.jar se trouve dans ORACLE_HOME/forms/java

1. Par défaut, WebUtil n'est PAS livré comme composant d'Oracle Application Server (WebUtil est livré uniquement comme composant d'Oracle Developer Suite) : vous devez donc récupérer la bonne version de frmwebutil.jar dans une installation d'Oracle Developer Suite correspondant à la même version d'Application Server.

Notez que si vous installez le correctif groupé 10.1.2.3.1, Patch 9593176, suivi du Patch 11710576, la bonne version de WebUtil pour la 10.1.2.3 sera installée


2. WebUtil 1.0.6 est la version de base de WebUtil. WebUtil 1.0.6 ne peut être utilisé qu'avec les versions 9.0.4 d'Oracle Forms.

2. Procurez-vous la bonne version de Jacob

a. Si vous utilisez une version antérieure de la 10gR2, comme la 10.1.2.0.2 ou la 10.1.2.2, utilisez :

JACOB 1.8

b. En revanche, si vous utilisez le correctif groupé 10.1.2.3.1 <> ou un correctif de courtoisie antérieur (super merge) comme le 9282569, vous devez utiliser Jacob 1.10.1, comme l'indique le fichier Readme.txt de ce correctif -> Jacob 1.10.1

Le readme de tout correctif de courtoisie (super merge) qui nécessite Jacob 1.10.1 précise cette exigence.

3. Créez le dossier "webutil" sous

%ORACLE_HOME%\forms

4. Copiez les fichiers suivants dans %ORACLE_HOME%\forms\webutil :

jacob.dll --> included in jacob_18.zip or jacob_1.10.1.zip as applicable.
d2kwut60.dll --> get it from Developer Suite under %ORACLE_HOME%\forms\webutil 
JNIsharedstubs.dll --> get it from Developer Suite under %ORACLE_HOME%\forms\webutil 
sign_webutil.bat --> get it from Developer Suite under %ORACLE_HOME%\forms\webutil

5. Copiez le fichier suivant dans %ORACLE_HOME%\forms\java :

jacob.jar(version 1.8 or 1.10.1 as applicable)

Notez que si vous avez installé le Patch 9593176, 9282569 ou 11710576, l'étape 6 n'est pas nécessaire. Ces correctifs installent la bonne version de frmwebutil.jar.

6. Copiez le fichier JAR de WebUtil, frmwebutil.jar, du répertoire %ORACLE_HOME%\forms\java de Developer Suite vers le répertoire %ORACLE_HOME%\forms\java de l'Application Server.

REMARQUE : ORACLE NE RECOMMANDE PAS AUX CLIENTS D'UTILISER LA 10.1.2.0.2 ACTUELLEMENT. LE CORRECTIF RECOMMANDÉ EST LA 10.1.2.3

Pour Forms 10.1.2.0.2, vous devrez appliquer le correctif 5017052. Ce correctif ajoute les fichiers JavaScript suivants et modifie les fichiers HTML de base de Forms pour qu'ils appellent ces nouveaux scripts.

ORACLE_HOME\java\forms_base_ie.js
ORACLE_HOME\java\forms_ie.js

Ces fichiers JavaScript sont nécessaires pour contourner les effets du correctif Microsoft KB912945, qui a modifié le fonctionnement du navigateur Internet Explorer. Si ces fichiers sont absents, vous pourriez obtenir un "écran blanc" au démarrage de l'applet.

7. Signez le fichier "jacob.jar" comme suit :

- start the command prompt 
- cd %ORACLE_HOME%\forms\java 
- set PATH=%ORACLE_HOME%\jdk\bin;%PATH% 
- %ORACLE_HOME%\forms\webutil\sign_webutil.bat %ORACLE_HOME%\forms\java\jacob.jar


8. Au besoin, copiez les fichiers suivants du répertoire %ORACLE_HOME%\forms\server de Developer Suite vers le répertoire %ORACLE_HOME%\forms\server de l'Application Server)

webutil.cfg

9. La variable suivante doit être définie dans %ORACLE_HOME%\forms\server\default.env :

WEBUTIL_CONFIG=<ORACLE_HOME>\forms\server\webutil.cfg


10. Les fichiers jar suivants doivent figurer dans le CLASSPATH du fichier forms/server/default.env :

%ORACLE_HOME%\forms\java\frmall.jar;%ORACLE_HOME%\forms\java\frmwebutil.jar;%ORACLE_HOME%\forms\java\jacob.jar;%ORACLE_HOME%\jdk\jre\lib\rt.jar


11. Le fichier de configuration formsweb.cfg doit contenir la section suivante :

[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

Si vous créez une section de configuration personnalisée pour exécuter WebUtil, incluez-y tous les paramètres ci-dessus. Sinon, vous obtiendrez l'erreur suivante :
load: class oracle.forms.webutil.common.RegisterWebUtil not found.

Par ailleurs, cette section de configuration est prévue pour utiliser le JRE de SUN et non JInitiator. JInitiator n'est plus pris en charge. Voir la Note 761159.1.


12. Le chemin virtuel suivant doit être défini dans le fichier %ORACLE_HOME%\forms\server\forms.conf :

AliasMatch ^/forms/webutil/(..*) "%ORACLE_HOME%/forms/webutil/$1"

Configuration du formulaire de démonstration WebUtil (la dernière version peut être téléchargée à partir de la Note 1272222.1)


13. Copiez le fichier DLL ffisamp.dll (inclus dans Webutil_demo.zip) dans

%ORACLE_HOME%\forms\webutil

14. Ouvrez le fichier webutil.cfg et ajoutez la ligne suivante

Add the following line : 
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

Notez que la taille de jacob.dll varie selon que vous utilisez jacob 1.8 ou 1.10.1. L'entrée ci-dessus correspond à jacob 1.10.1. L'entrée pour jacob 1.8 est -> install.syslib.0.7.1=jacob.dll|94208|1.0|true

15. Dans le fichier webutil.cfg, assurez-vous d'avoir les lignes

transfer.appsrv.workAreaRoot=d:\temp 
transfer.appsrv.accessControl=FALSE 
transfer.database.enabled=TRUE 
transfer.appsrv.enabled=TRUE

16. Créez un utilisateur de base de données "Webutil".

17. Exécutez le script (présent dans l'installation de Developer Suite)

%ORACLE_HOME%\forms\create_webutil_db.sql

18. Créez un fichier nommé d:\temp\downloaded_from_as.txt et ajoutez-y du texte. Ce fichier de test servira à démontrer le chargement de fichiers de l'Application Server vers le poste client. Le test de téléchargement s'attend à trouver ce fichier à cet emplacement sur l'Application Server.

19. Ouvrez Forms Builder et connectez-vous en tant qu'utilisateur "Webutil". Faites "Compile ALL" (shift-Control-K) sur le formulaire webutil_demo.fmb et sur webutil.pll, puis générez le fmx et le plx avec (Control-T).

20. Déplacez les fichiers suivants dans %ORACLE_HOME%\forms :

webutil_demo.fmx 
webutil plx 
webutil.olb

21. Exécutez le formulaire de démonstration webutil_demo comme suit pour vérifier que l'installation s'est bien déroulée :

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

22. Pour plus d'informations, consultez la documentation de WebUtil (en particulier "Runtime Setup Checklist" et
"WebUtil Installation Steps"). Vous y trouverez aussi des informations sur les différentes unités de programme de WebUtil :

Documentation de WebUtil

23. Vous pouvez aussi exécuter le formulaire de test de diagnostic décrit dans la note suivante pour vérifier plus en détail la configuration de WebUtil :
Note :553849.1Webutil Diagnostic Test Form For Checking Webutil Configuration

Tous les articles