Ce chapitre décrit les étapes nécessaires afin de déterminer la
cause d'un problème survenu lors du déploiement d'une application. Il présente également des solutions
possibles.
Avant de commencer
Cette rubrique suppose que les conditions suivantes sont remplies :
- Vous comprenez les principes de base du débogage d'un module.
- Les fonctions de journalisation et de trace sont actives pendant le déploiement du module.
Pourquoi et quand exécuter cette tâche
La tâche de résolution des incidents de déploiement commence lorsque vous recevez une notification d'erreur. Lors d'un échec de déploiement, il existe divers symptômes que vous devez
inspecter avant
d'agir.
Procédure
- Déterminez si l'installation de l'application a échoué.
Cherchez dans le fichier
SystemOut.log des messages qui indiquent la cause de l'échec. Les raisons de l'échec de l'installation d'une application peuvent être notamment les suivantes :
- Vous essayez d'installer une application sur plusieurs serveurs dans la même cellule Network Deployment.
- Une application possède le même nom qu'un module existant de la cellule Network Deployment dans laquelle vous installez l'application.
- Vous essayez de déployer des modules J2EE dans un fichier EAR sur différents serveurs cible.
Important : Si l'installation a échoué et que l'application contient des services, vous devez supprimer toutes les destinations SIBus ou les spécifications d'activation J2C créées avant l'échec et avant la tentative de réinstallation de l'application. Le moyen le plus simple de supprimer ces artefacts est de cliquer sur Sauvegarder -> Annuler tout après l'échec. Si vous enregistrez par inadvertance les modifications, vous devez supprimer manuellement les destinations SIBus et les spécifications d'activation J2C (voir les rubriques concernant la suppression des destinations SIBusand et les spécifications
d'activation J2C).
- Si l'application est installée correctement, examinez-la pour déterminer si elle a été démarrée avec succès.
Si le démarrage de l'application a échoué, l'échec s'est produit lorsque le
serveur a tenté d'initier les ressources de
l'application.
- Cherchez dans le fichier SystemOut.log des messages
qui vous indiquent comment continuer.
- Déterminez si les ressources requises par l'application sont disponibles et/ou si leur démarrage a réussi.
Les ressources qui n'ont pas démarré empêchent une application de s'exécuter. Cela empêche la perte d'informations. Les raisons pour lesquelles une ressource ne démarre pas incluent :
- Les liaisons sont spécifiées de manière
incorrecte
- Les ressources sont configurées de manière
incorrecte
- Les ressources ne se trouvent pas dans le fichier RAR (fichier archive de ressources)
- Des ressources Web ne se trouvent pas dans le fichier WAR (fichier archive de services Web)
- Déterminez si des composants sont manquants.
La raison de l'absence d'un composant est un fichier EAR mal compilé. Assurez-vous que
tous les composants requis par le module se trouvent dans les dossiers appropriés du
système test sur lequel vous avez compilé le fichier JAR (archive
Java™). "Préparation du déploiement sur un serveur" contient des informations supplémentaires.
- Regardez si des informations circulent dans l'application.
Même une application en
cours d'exécution peut rencontrer un échec lors du traitement des informations.
Les raisons de ce problème sont similaires à celles qui sont mentionnées à l'étape
2.b.
- Déterminez si l'application utilise des services contenus dans une autre application. Vérifiez que l'autre application est installée et a démarré avec succès.
- Déterminez si les liaisons d'importation et d'exportation de tous les services contenus dans d'autres applications utilisées par l'application défaillante sont configurées correctement. Utilisez la console d'administration pour examiner et corriger les liaisons.
- Corrigez le problème et relancez
l'application.