Installez des adaptateurs de ressources dans vos applications, afin qu'elles
soient accessibles hors des sources de données.
Avant de commencer
La spécification de l'architecture JCA version 1.6 prend en charge les annotations Java dans les modules RAR. Pour plus d'informations sur la prose en charge des annotations, consultez la rubrique Prise en charge des annotations dans les modules RAR par la spécification JCA 1.6.
Pourquoi et quand exécuter cette tâche
Procédure
- Assemblez une application avec des modules RAR dedans.
Pour plus d'informations, voir la rubrique relative à l'assemblage d'applications.
- Installez l'application. Installez une nouvelle application en suivant les instructions de la rubrique.
A l'étape Mapper les modules vers les serveurs, spécifiez un serveur ou
un cluster cible pour chaque fichier RAR. Veillez à mapper vers la même cible tous les autres modules
qui utilisent les adaptateurs de ressources définis dans un fichier RAR donné. Spécifiez également les serveurs Web en tant que cibles servant de routeurs pour requêtes adressées à cette application. Le fichier de configuration de plug-in (plugin-cfg.xml)
de chaque serveur Web est généré en fonction des applications transitant via ce serveur.
A l'étape Métadonnées pour des modules de l'installation d'une application, vous pouvez activer ou désactiver l'indicateur metadata-complete, comme indiqué à à rubrique Prise en charge des annotations dans les modules RAR par la spécification JCA 1.6.
Remarque : Lors de l'installation d'un fichier RAR sur un serveur, le serveur d'applications
recherche le manifeste (MANIFEST.MF) du module de connecteur. Le serveur d'applications recherche d'abord le fichier
connectorModule.jar du fichier RAR et charge le manifeste à partir du fichier
connectorModule.jar.
Si l'entrée de chemin d'accès aux classes se trouve dans le manifeste du fichier
connectorModule.jar, le fichier RAR utilise ce chemin d'accès aux classes.
Pour vous assurer que le module de connecteur installé trouve les classes et les ressources dont il a besoin, vérifiez le paramètre de chemin d'accès aux classes du fichier RAR à l'aide de la console d'administration. Pour plus d'informations sur la façon de vérifier ce paramètre, voir la rubrique Paramètre de l'adaptateur de ressources et paramètres d'adaptateur de ressources relationnelles WebSphere.
- Cliquez sur Terminer > Sauvegarder pour enregistrer les modifications.
- Créez des fabriques de connexions pour l'application nouvellement installée.
Pour connaître les opérations à effectuer pour cette étape, consultez la rubrique Configuration de fabriques de connexions pour les adaptateurs de ressources dans les applications.
Résultats
Remarque : Une bibliothèque native donnée ne peut être chargée qu'une seule fois par instance
de la JVM (machine virtuelle Java™). Comme chaque application possède son propre chargeur de classes, deux applications
distinctes, incorporant des fichiers RAR, ne peuvent pas utiliser simultanément la
même bibliothèque native. La seconde application reçoit une exception lorsqu'elle tente de charger
la bibliothèque.
Si une application déployée sur le serveur d'applications incorpore un fichier RAR qui inclut des éléments de chemin natif, vous devez toujours veiller à arrêter proprement le serveur d'applications, sans que des transactions restent en suspens. En effet, si le serveur d'applications
n'est pas arrêté proprement, il effectuera une reprise à son redémarrage suivant et chargera tous les fichiers RAR
et les bibliothèques natives nécessaires.
Dans ce cas, au terme de la reprise, ne tentez aucune tâche en rapport avec les
applications hébergées. Fermez le serveur et redémarrez-le. Lors de ce deuxième redémarrage, aucune autre procédure de
reprise n'est tentée par le serveur d'applications et le traitement normal des applications
peut alors se poursuivre.