Utilisez l'assistant de mise à jour d'archive d'adaptateur de ressources (RAR) pour mettre à jour les fichiers RAR autonomes vers une version plus récente. Le
serveur d'applications utilise les classes et d'autres codes inclus dans une archive d'adaptateur de ressources
(RAR) pour prendre en charge les adaptateurs de ressources que vous configurez.
Avant de commencer
Un adaptateur de ressources doit être installé sur le serveur d'applications
et vous devez avoir une nouvelle version de l'adaptateur de ressources qui est
compatible avec l'ancienne version. Vous pouvez créer le fichier RAR à l'aide d'un outil d'assemblage ou le fournisseur de l'adaptateur de ressources peut fournir la nouvelle version.
Si la nouvelle version d'un fichier RAR n'est pas compatible avec
l'ancienne version de l'adaptateur de ressources, aucune mise à jour n'est possible.
La spécification Java™ Connector Architecture (JCA) version 1.6 ajoute le support d'annotations Java aux modules RAR. Pour plus d'informations sur la prise en charge des annotations et les métadonnées, 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
Mettez à jour un fichier RAR lorsque vous estimez qu'un adaptateur de ressources
ou un ensemble d'adaptateurs de ressources doit être mis à jour avec une version différente. Les diverses versions des adaptateurs de ressources peuvent comporter des paramètres différents. Par conséquent, la mise à jour de votre adaptateur peut être bénéfique si vous recherchez un ensemble d'options de configuration particulier.
Vous avez le choix de mettre à jour l'adaptateur de ressources pour tous les noeuds d'une cellule ou tous les noeuds d'un cluster. Si certains des noeuds sont antérieurs à la version 7.0, la mise à jour RAR n'est pas prise en charge tant que ces noeuds ne sont pas migrés vers la version 7.0. Les mises à jour des adaptateurs JCA 1.6 ne s'appliquent qu'à un noeud Version 9.0.
Si vous préférez avoir plusieurs versions d'un adaptateur de ressources actives dans une machine JVM (Java Virtual Machine) spécifique, l'assistant de mise à jour n'inclut pas l'option permettant de créer une autre version et de conserver l'ancienne. Dans ce cas, vous devez créer un adaptateur de ressources isolé et le configurer en conséquence. Pour plus d'informations, consultez la rubrique relative à la configuration d'un adaptateur de ressources.
Procédure
- Sauvegardez toutes les modifications de configuration.
- Sauvegardez vos paramètres de configuration à l'aide de l'outil backupConfig. Ce dernier se trouve dans le répertoire racine_serveur_app/bin.
Pour plus d'informations sur l'utilisation de la commande backupConfig, consultez la rubrique la concernant.
- Synchronisez l'un des noeuds pour la mise à jour.
- Vérifiez que les agents de noeud sont en cours d'exécution s'ils sont associés à l'adaptateur de ressources que vous mettez à jour.
- Arrêtez tous les serveurs qui contiennent le fichier RAR qui est mis à jour.
Vous devez arrêter tous les serveurs du noeud ou cluster auquel le fichier RAR est associé. Pour en savoir plus sur la manière d'arrêter ou de démarrer un serveur d'applications, reportez-vous à la rubrique Administration des applications et de leur environnement.
- Cliquez sur .
- Cochez la case en regard du fichier RAR à mettre à jour, puis cliquez sur Mise à jour RAR.
- Indiquez le chemin d'installation du fichier RAR puis cliquez sur Suivant.
- Si votre fichier RAR se trouve sur le même poste de travail que votre navigateur,
sélectionnez Système de fichiers local et recherchez le fichier.
- Si votre fichier RAR se trouve sur le poste de travail serveur où le serveur d'applications
est installé, sélectionnez Système de fichiers éloigné et indiquez le chemin
complet du fichier.
- Consultez les informations de configuration fournies pour le fichier RAR. Les informations suivantes s'affichent pour le fichier RAR :
- Chaîne
- Version RAR en cours
- Nouvelle version RAR
- Portée
- Toute copie existante de l'adaptateur de ressources. Les adaptateurs de ressources comportant un astérisque(*) sont des copies de l'adaptateur de ressources et doivent également être mis à jour au même moment.
Cliquez sur Suivant après avoir terminé.
- Facultatif : Editez les propriétés qui ont été ajoutées par la nouvelle version de l'adaptateur
de ressources. Vous pouvez également éditer ces propriétés après avoir terminé la
mise à jour.
- Sélectionnez une ressource dans la liste pour éditer les nouvelles propriétés. Seules les ressources avec de nouvelles propriétés sont incluses dans la liste.
- Editez les propriétés de la ressource. Utilisez le tableau fourni pour définir les valeurs des nouvelles propriétés de la ressource sélectionnée.
- Cochez la case Définir pour tous pour appliquer la valeur de la propriété à toutes les ressources du même type.
- Cliquez sur le bouton Réinitialiser à la valeur par défaut pour restaurer à toutes les propriétés les valeurs par défaut définies dans le fichier RAR. Cette réinitialisation de propriété n'affecte que la ressource sélectionnée.
- Cliquez sur Next.
- Consultez le panneau récapitulatif et cliquez sur Terminer lorsque les paramètres de configuration vous conviennent. Lorsque vous cliquez sur Terminer, toutes les modifications de configuration sont automatiquement sauvegardées.
Pour revenir à une version antérieure de l'adaptateur de ressources, vous devez effectuer à nouveau le processus de mise à jour et indiquer la version antérieure du fichier RAR.
- Redémarrez les serveurs qui contiennent le fichier RAR mis à jour.
Que faire ensuite
Si vous n'êtes pas satisfait des résultats et si vous avez sauvegardé votre configuration à l'aide de l'outil backupConfig, utilisez l'outil restoreConfig pour la restaurer. Pour plus d'informations sur l'utilisation de la commande restoreConfig, consultez la rubrique la concernant.