Le déploiement d'une application d'accès aux données requiert plus que la simple
installation d'un fichier WAR (web archive) ou EAR (enterprise archive) sur un serveur. Le déploiement peut inclure des
tâches qui configurent l'application pour qu'elle utilise les ressources d'accès aux données du serveur et
l'environnement d'exécution global.
Avant de commencer
Vous pouvez uniquement déployer un code d'application ayant été assemblé en modules appropriés. Pour obtenir des
instructions sur ce processus, consultez la rubrique Assemblage d'applications d'accès aux données.
Pourquoi et quand exécuter cette tâche
Si votre application requiert l'accès à une base de données relationnelles, effectuez les opérations ci-dessous. Lorsque votre application nécessite l'accès à un type de système différent, tel qu'une base de données orientée objet
ou le système CICS (Customer Information Control System), consultez les
rubriques Adaptateur de ressources relationnelle et JCA et Accès aux données à l'aide des connecteurs JCA
(Java™ EE Connector Architecture).
Procédure
- Si la configuration de la base de données relationnelle n'existe pas, procédez comme suit :
- Créez une base de données destinée à recevoir les données.
- Créez les tables requises par votre application.
- Si l'application utilise des beans entity CMP (container managed persistence) pour accéder aux données
- Vous pouvez créer les tables en utilisant le fichier DDL
(Data Definition Language) généré à partir de la configuration
des EJB. Pour plus d'informations, consultez la rubrique Recréation des tables de base de données à partir du fichier DDL exporté.
- Si l'application utilise des beans entity BMP (bean managed persistence) ou n'utilise
pas de beans entity
- Vous devez utiliser les interfaces
de votre serveur de base de données pour créer les tables.
L'assistant de mappage EJB (Enterprise JavaBeans) vers RDB d'un outil
d'assemblage est également utilisé pour créer les tables de base de données pour tout type de bean entity.
Sélectionnez l'option de mappage descendant dans l'assistant. Toutefois, cette option ne vous permet pas de contrôler directement le nom des éléments RDB ou le choix du type de
colonne. En outre, le processus descendant étant automatique, il risque de ne pas fournir des mappages qui reflètent avec précision les relations que vous souhaitez établir.
Si vous utilisez Rational Application Developer, consultez le centre de
documentation relatif à l'assistant de mappage. Pour découvrir toutes les options de l'outil d'assemblage, consultez la rubrique relative aux outils d'assemblage inclus
dans ce centre de documentation.
- Consultez les paramètres minimum requis des sources de données par fournisseur, afin de connaître les prérequis du fournisseur de base de données concernant la connexion à un serveur d'applications. Pour obtenir des instructions, reportez-vous à la rubrique Paramètres minimum requis des sources de données par
fournisseur.
- Facultatif : Mappez les beans entity aux tables de la base de données à l'aide de l'option de mappage de rapprochement d'un outil d'assemblage. Effectuez cette étape uniquement si vous n'avez pas créé le schéma de la base de données via l'option de mappage descendant, si vous n'avez pas généré vos relations de mappage via l'option de mappage descendant ou si n'avez pas généré de mappages lors de la procédure d'assemblage d'applications. Pour plus d'informations sur l'option de mappage descendant, consultez le centre de documentation de Rational Application Developer.
- Installez l'application sur le serveur d'applications. Voir la rubrique relative à l'installation des fichiers des applications d'entreprise. Lorsque vous installez
l'application, vous pouvez modifier les paramètres d'accès aux données définis lors de l'assemblage d'application ou
les définir pour la première fois s'ils ont été omis lors de la procédure d'assemblage. Ces paramètres incluent les liaisons des ressources et les alias d'authentification des ressources, présentés dans les étapes suivantes :
- Liez les références des ressources d'applications aux sources de données ou d'autres objets de ressource qui fournissent la connectivité de la base de données. Pour plus de détails sur le concept de liaison, voir la rubrique Consultation de source de données pour bean
enterprise et modules Web.
Conseil : A l'issue du déploiement, vous pouvez utiliser la console d'administration de WebSphere Application Server pour modifier les liaisons de ressources. Cliquez sur , puis sélectionnez le lien vers la page de mappage approprié. Par exemple, si vous souhaitez modifier la liaison d'une ressource de module EJB, cliquez sur Mapper les sources de données pour tous les beans CMP 2.x. Pour une ressource de module Web, cliquez sur Références de ressources.
- Définissez les données de l'alias d'authentification pour les ressources qui doivent être authentifiées auprès du système dorsal via une autorisation gérée par le conteneur. Dans cette configuration de sécurité, WebSphere Application Server effectue une ouverture de session EIS pour les connexions de la source de données ou de la fabrique de connexions. Pour des références détaillées sur l'authentification des ressources, consultez la rubrique relative à la sécurité des
connecteurs J2EE.
- Lancez les fichiers de l'application déployée à l'aide de la console d'administration, de la commande startApplication de l'outil de scriptage wsadmin, ou de votre propre programme
Java.
- Sauvegardez les modifications de la configuration d'administration.
- Testez l'application. Par exemple, pointez
un navigateur Web sur l'URL d'une application déployée et vérifiez ses performances.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Résultats
Lorsque vous déployez une application qui utilise une base de données d'arrière-plan
DB2 UDB for IBM® i,
il se peut que vous rencontriez l'exception suivante dans le
fichier SystemOut.log :
PMGR6022E : Erreur lors de l'utilisation d'un adaptateur pour créer ou exécuter une interaction
Ce type d'erreur indique que vous avez déployé une application avec des beans enterprise CMP (persistance gérée par conteneur) qui étaient configurés, au départ, pour accéder à une base de données DB2 sous Windows, Linux ou sur un système UNIX pris en charge. Au moyen de la console d'administration, désinstallez les applications CMP affectées, puis réinstallez-les avec le nouveau paramètre de base de données. N'oubliez pas de sélectionner
Déploiement de beans enterprise. Dans le panneau
Déploiement EJB,
sélectionnez la version appropriée de votre base de données DB2 UDB for
IBM i.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL
en vue du traitement des incidents liés aux applications.
Que faire ensuite
Si l'application ne fonctionne pas comme vous le souhaitez, mettez à jour l'application, sauvegardez-la et testez-la une nouvelle fois.