Lors du déploiement d'un module JavaBeans (EJB), le module est installé sur un serveur préalablement configuré pour prendre en charge des modules déployés.
Avant de commencer
Assemblez un ou plusieurs modules EJB, assemblez un ou plusieurs modules Web et assemblez-les dans une application Java™ EE.
Pour
obtenir un aperçu des modifications au niveau du modèle de déploiement EJB pour EJB
3.x, voir la rubrique relative à la présentation du déploiement EJB 3.x.
Procédure
- Préparez l'environnement de déploiement. Voir la rubrique relative à la préparation des applications hôtes.
- Mettez à jour la
configuration pour chaque module EJB en fonction des besoins de l'environnement
de déploiement.
- Obligatoire : Si un module comporte des dépendances
sur des extensions propres à Java 5, telles
que des génériques, des annotations, etc., vous devez exécuter séparément l'outil de ligne de commande EJBDeploy,
avant d'installer le module ou l'application qui le contient. En effet, la console d'administration, ainsi
que l'outil de commande en ligne wsadmin ne permettent pas la spécification de l'option
ejbdeploy -complianceLevel 5.0.
Cela est nécessaire uniquement pour exécuter l'outil EJBDeploy pour les modules
2.1 contenant les entités beans.
- Corrigez les incidents potentielsd'interopérabilité.
Des résultats inattendus peuvent se produire si un produit de la famille WebSphere
ou un autre produit, exécuté sur une version d'Application Server
non compatible avec EJB 3.x tente d'appeler à distance une méthode
sur un bean enterprise compatible EJB 3.x sur un serveur séparé exécutant
une version d'Application Server prenant en charge EJB 3.x. Si ces produits
tentent d'appeler une méthode via l'interface de gestion à distance EJB 3.x
du bean enterprise, ils risquent de rencontrer des exceptions introduites
par EJB 3.x. Ces exceptions seront renvoyées vers l'environnement non
compatible avec EJB 3.x.
Cette situation peut poser problème pour l'administrateur d'un environnement comprenant une combinaison de produits WebSphere avec des instances d'Application Server compatibles avec EJB 3.x et d'autres non compatibles.
Voici la liste des classes d'exception introduites par EJB 3.0 :
- javax.ejb.ConcurrentAccessException
- javax.ejb.EJBAccessException
- javax.ejb.EJBTransactionRequiredException
- javax.ejb.EJBTransactionRolledbackException
- javax.ejb.NoSuchEJBException
- Assurez-vous que le serveur d'applications est mis à jour avec la version 7.0.0.3.
- Copiez manuellement le fichier <racine_serveur_app>/runtimes/ejb3exceptions.jar
du serveur d'applications dans un répertoire sur chacune des installations de produits
de la piloe, ou d'autres installations de produits, que vous utiliserez en
tant que client EJB 3.x.
- Assurez-vous que le répertoire qui contient le fichier ejb3exceptions.jar
se trouve dans le chemin de classe. Un des emplacements possibles pour le fichier JAR, qui répond à cette exigence,
est le répertoire <racine_serveur_app>/lib
sur un serveur non compatible avec EJB 3.x.
Eviter les incidents: A l'instar des fichiers jar de client léger EJB,
si une mise à jour est disponible, les utilisateurs doivent copier le fichier ejb3exceptions.jar
à nouveau après avoir installé la version WebSphere Application Server qui contient la version mise à jour.
gotcha
- Déployez l'application. Voir la rubrique relative au déploiement et à l'administration des applications d'entreprise.
Que faire ensuite
Si vous spécifiez que l'outil EJBDeploy doit s'exécuter lors de l'installation
de l'application et que l'installation échoue avec un message d'erreur
NameNotFoundException, vérifiez que le fichier d'entrée JAR (Java archive) ou EAR (enterprise archive) ne contient pas de
fichiers source. Supprimez les fichiers source ou intégrez au chemin d'accès aux classes
toutes les classes dépendantes et tous les fichiers de ressources. Si le fichier
d'entrée JAR ou EAR contient des fichiers source, les outils de déploiement EJB exécutent
une reconstruction avant de générer le code de déploiement.
Si le déploiement du module
réussit, testez et déboguez le module. Voir la rubrique Diagnostic des incidents (à l'aide des outils de diagnostic).