WebSphere Extended Deployment, Version 6.0.x     Systèmes d'exploitation : AIX, HP-UX, Linux, Solaris, Windows, z/OS

Modification des modules de remplacement des beans enterprise

La procédure de déploiement d'EJB standard génère des modules de remplacement compatibles avec les clusters. Ces modules de remplacement peuvent être modifiés au cours d'une seconde procédure pour prendre en charge l'acheminement vers des partitions. L'outil fourni utilise le fichier EAR et génère un nouveau fichier EAR avec les modules de remplacement modifiés. Les modules de remplacement sont modifiés pour tous les EJB prenant en charge l'acheminement vers les partitions. Un bean prenant en charge l'acheminement vers les partitions est un bean session sans état doté d'une interface éloignée et d'une classe de routeur XXX_PartitionKey (POJO).

L'outil wpfStubUtil se trouve dans le répertoire <racine_installation_WAS>/bin. Exécutez cet outil pour les fichiers EAR partitionnés après le lancement de la commande ejbdeploy. La syntaxe de wpfStubUtil est indiquée ci-après. L'outil risque d'échouer si l'ordre n'est pas respecté.

wpfStubUtil -ear <nom fichier ear> -jar <nom fichier jar> -class <nom de classe> -temp <
répertoire de travail temp> [options facultatives : -stubUpdateClasspath <chemin d'accès aux classes
> -verbose -stubDebug -keep -rmicextclasspath <chemin_d'accès_aux_classes>
-extdirs <javac extdirs>]

Les options -ear, -jar, -class et -temp sont toutes obligatoires. La commande -stubUpdateClasspath est facultative mais si elle est utilisée, elle doit être le premier argument après le répertoire de travail temp.
Explication de chaque option :
-ear <nom du fichier ear>
Fichier ear contenant l'application partitionnée.
-jar <nom du fichier jar>
Fichier JAR du bean enterprise stocké dans le fichier EAR qui contient le bean enterprise partitionné.
-class <nom de classe>
Classe de l'interface éloignée du bean.
-temp <répertoire de travail temporaire>
Répertoire où tous les travaux sont effectués.
-stubUpdateClasspath <chemin d'accès aux classes>
(facultatif) Outil qui ajoute son chemin d'accès aux classes aux données transmises par l'utilisateur.
-verbose
(facultatif) Option déterminant la quantité de données générées par l'outil.
-stubDebug
(facultatif) Place des données de débogage supplémentaires dans le module de remplacement. Cette option ne doit pas être utilisée dans un environnement de production.
-keep
(facultatif) Conserve le contenu du répertoire de travail temporaire à la fin de l'exécution de l'outil.
-rmicextclasspath <chemin d'accès aux classes>
(facultatif) Ajoute les données indiquées par l'utilisateur au chemin d'accès aux classes rmic.
-extdirs <javac extdirs>
(facultatif) Ajoute les données indiquées par l'utilisateur à javac extdirs.
wpfStubUtil peut mettre à jour tous les EJB dotés d'une classe XXX_PartitionKey définie. Les EJB session peut être des beans PRSB ou PSSB.
Exemple illustrant l'exécution de l'outil wpfStubUtil pour un fichier ear contenant un bean PRSB façade :
C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear 
D_WPFFacadePartitionSample.ear -jar 
WPFKeyBasedPartitionEJB.jar -class com/ibm/websphere/wpf/ejb/
WPFKeyBasedPartition.class -temp \working
Un sous-répertoire ou un fichier \working existe déjà.
WPFC0069I: Décompression du fichier ear D_WPFFacadePartitionSample.ear
WPFC0070I: Décompression du fichier jar WPFKeyBasedPartitionEJB.jar
WPFC0071I:  Exécution de rmic pour générer la source du module de remplacement
[rmic output - removed]
 [terminé en 2334 ms]
WPFC0072I: Mise à jour de la source du module de remplacement
WPFC0073I: Compilation de la source du module de remplacement modifiée
WPFC0074I: Nouvelle intégration du fichier jar WPFKeyBasedPartitionEJB.jar
WPFC0075I: Nouvelle intégration du fichier ear D_WPFFacadePartitionSample.ear
Nettoyage
Exemple illustrant l'exécution de l'outil wpfStubUtil pour deux fichiers ear contenant un bean session PRSB. Notez que le fichier D_StockAccount.ear requiert un fichier JAR supplémentaire (StockEJB.jar) à ajouter au chemin d'accès aux classes rmic (-rmicextclasspath), stubUpdateClasspath (-stubUpdateClasspath) et javac ext dirs (-extdirs) :
C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear D_Stock.ear 
-jar StockEJB.jar -class 
wpf/test/stock/ejb/ProcessStock.class -temp \working
Un sous-répertoire ou un fichier \working existe déjà.
WPFC0069I: Décompression du fichier ear D_Stock.ear
WPFC0070I: Décompression du fichier jar StockEJB.jar
WPFC0071I:  Exécution de rmic pour générer la source du module de remplacement
[rmic output - removed]
 [terminé en 2324 ms]
WPFC0072I: Mise à jour de la source du module de remplacement
WPFC0073I: Compilation de la source du module de remplacement modifiée
WPFC0074I: Nouvelle intégration du fichier jar StockEJB.jar
WPFC0075I: Nouvelle intégration du fichier ear D_Stock.ear
Nettoyage

C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear 
D_StockAccount.ear -jar 
StockAccountEJB.jar -class wpf/test/stockaccount/ejb/
Process.class -temp \working 
-stubUpdateClasspath \stub\StockEJB.jar -rmiextclasspath \stub\ 
StockEJB.jar -extdirs 
\stub\StockEJB.jar
Un sous-répertoire ou un fichier \working existe déjà.
WPFC0069I: Décompression du fichier ear D_StockAccount.ear
WPFC0070I: Décompression du fichier jar StockAccountEJB.jar
WPFC0071I:  Exécution de rmic pour générer la source du module de remplacement
[rmic output - removed]
[terminé en 2333 ms]
WPFC0072I: Mise à jour de la source du module de remplacement
WPFC0073I: Compilation de la source du module de remplacement modifiée
WPFC0074I: Nouvelle intégration du fichier jar StockAccountEJB.jar
WPFC0075I: Nouvelle intégration du fichier ear D_StockAccount.ear
Nettoyage
Exemple illustrant l'exécution de l'outil wpfStubUtil pour un fichier ear contenant uniquement un bean PSSB :
C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear 
D_WPFKeyBasedPartitionSample.ear 
-jar WPFKeyBasedPartitionEJB.jar -class com/ibm/websphere/wpf/ejb/
WPFKeyBasedPartition.class
 -temp \working
Un sous-répertoire ou un fichier \working existe déjà.
WPFC0069I: Décompression du fichier ear D_WPFKeyBasedPartitionSample.ear
WPFC0070I: Décompression du fichier jar WPFKeyBasedPartitionEJB.jar
WPFC0071I:  Exécution de rmic pour générer la source du module de remplacement
[rmic output - removed]
[terminé en 2373 ms]
WPFC0072I: Mise à jour de la source du module de remplacement
WPFC0073I: Compilation de la source du module de remplacement modifiée
WPFC0074I: Nouvelle intégration du fichier jar WPFKeyBasedPartitionEJB.jar
WPFC0075I: Nouvelle intégration du fichier ear D_WPFKeyBasedPartitionSample.ear
Nettoyage

Dans certains cas, wpfStubUtil ne parvient pas à trouver une classe même si celle-ci se trouve dans un fichier JAR défini dans le chemin d'accès aux classes. Dans ce cas, décompressez toutes les classes du fichier JAR contenant la classe introuvable en entrant -temp <répertoire de travail temporaire>.




Related concepts
Modèle de programmation de la fonction de partitionnement

Rubrique Concept    

Conditions d'utilisation | Commentaires Dernière mise à jour le : Mar 16, 2006 10:01:30 AM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=?topic=/com.ibm.websphere.xd.doc/info/WPF51/cwpfejbstub.html

© Copyright IBM 2005, 2006. All Rights Reserved.
Ce centre de documentation s'appuie sur la technologie Eclipse. (http://www.eclipse.org)