Incidents liés au démarrage d'une application
Utilisez ces informations pour résoudre des incidents qui se produisent lors du démarrage d'une application.
Quel type de message d'erreur s'affiche au démarrage d'une application ?
- Le serveur HTTP et le serveur d'applications fonctionnent séparément, mais les demandes ne sont pas transmises du serveur HTTP au serveur d'applications
- Incidents liés au service de fichiers
- Les graphiques ne s'affichent pas sur la sortie du fichier JSP ou du servlet
- SRVE0026E : [Erreur servlet]-[Compilation de classe impossible pour JSP
Après modification et sauvegarde d'un fichier JSP, les modifications n'apparaissent pas dans le navigateur
- Message d'erreur : /jspname.jsp(9,0) Include : page d'attribut obligatoire manquante
La source Java générée à partir d'un fichier JSP n'est pas conservée dans le répertoire temporaire
- Erreur "Application Enterprise [nom de l'application que vous avez entré] introuvable"
- Problème de conversion des entrées du navigateur qui ne sont pas en anglais
- Les barres de défilement ne s'affichent pas autour des éléments dans la fenêtre du navigateur
- Erreur "Impossible d'afficher la page ; serveur introuvable ou erreur DNS"
L'exception DeploymentDescriptorLoadException apparaît lors du démarrage d'une application

Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.
Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.
sptcfgLe serveur HTTP et le serveur d'applications fonctionnent séparément, mais les demandes ne sont pas transmises du serveur HTTP au serveur d'applications
Si votre serveur HTTP semble fonctionner correctement et que le serveur d'applications fonctionne aussi de son côté mais que les requêtes de pages que le navigateur envoie au serveur HTTP restent sans réponse, cela indique un incident au niveau du plug-in WebSphere Application Server.
Dans ce cas, procédez comme suit :
- Déterminez si le serveur HTTP tente de servir lui-même la ressource demandée au lieu de la transmettre
à WebSphere Application Server.
- Dans le journal des accès du serveur HTTP (répertoire principal d'installation IHS/logs/access.log, recherchez IBM HTTP Server. Il est possible que le fichier soit introuvable dans son son propre répertoire racine des documents.
- Parcourez le fichier journal du plug-in.
- Réactualisez le fichier plugin-cfg.xml qui détermine les requêtes envoyées au serveur HTTP
qui doivent être transmises à WebSphere
Application Server, et à quel serveur d'applications. Utilisez la console de la façon suivante pour actualiser ce fichier :
- Dans la console d'administration WebSphere Application Server, développez l'arborescence Environnement.
- Cliquez sur Mise à jour de l'extension WebSphere.
- Arrêtez, puis redémarrez le serveur HTTP.
Si vous utilisez IBM HTTP Server for iSeries ou Lotus Domino for iSeries, il n'est pas nécessaire de redémarrer le serveur HTTP.
- Relancez la requête web.
Si vous avez créé une définition de serveur Web pour modéliser votre instance de serveur Web, le fichier se trouve dans racine_profil/config/cells/nom_cellule/nodes/nom_noeud_serveur_Web/servers/nom_serveur_Web. Dans le cas contraire, le fichier se trouve dans racine_profil/config/cells.
- Parcourez le fichier racine_installation_plugin/logs/nom_serveur_web/http_plugin.log pour obtenir des indices sur l'incident. Assurez-vous que la ligne d'informations sur l'extension dont l'horodatage est le plus récent, qui s'imprime au chargement de l'extension, correspond à l'heure de démarrage du serveur web.
- Activez le traçage de l'extension en définissant l'attribut LogLevel du fichier plugin-cfg.xml à Trace et en rechargeant la demande. Parcourez le fichier racine_install_plugin/logs/nom_serveur_Web/http_plugin.log. Le fichier plugin-cfg.xml doit vous indiquer quelle est l'extension qui tente d'apparier l'URI demandé aux diverses définitions d'URI pour les routes. Vérifiez les règles auxquelles l'extension ne se conforme pas et déterminez si vous devez en ajouter. Si vous venez juste d'installer l'application, il vous faudra peut-être régénérer manuellement la configuration de l'extension afin de récupérer les URI relatifs à la nouvelle application.
Pour plus de détails sur la détermination et la résolution des incidents liés à l'extension, reportez-vous à la rubrique Conseils de résolution des incidents liés au plug-in du serveur Web.
Incidents liés au service de fichiers
Si la sortie texte s'affiche sur la page Web de votre JSP (ou servlet), mais que les fichiers d'images ne s'affichent pas :
- Verify that your files are in the correct location: the document root
directory of your web application WebSphere Application Server follows the J2EE standard, which means that
the document root is the web_module_name.war directory of
your deployed web application.
En général, le répertoire se trouve à l'emplacement racine_install/installedApps/nomnoeud/nomapplication.ear ou racine_installation/installedApps/nomnoeud/nomapplicationNetwork.ear.
En général, le répertoire se trouve à l'emplacement racine_profile/installedApps/nomnoeud/nomapplication.ear ou racine_installation/installedApps/nomnoeud/nomapplicationNetwork.ear.
Si les fichiers se trouvent dans un sous-répertoire de la racine des documents, vérifiez que la référence au fichier le mentionne. Cela signifie que si le fichier invoices.html est stocké dans le répertoire Windows nom_module_Web.war\invoices, le lien dans les autres pages de l'application Web permettant de l'afficher doit être "invoices\invoices.html" et non "invoices.html".
- Pour vérifier que votre application web est configurée pour activer
le service de fichiers et qu'elle est en mesure d'afficher des ressources statiques telles que
des fichiers d'images et .html, procédez comme suit :
Afficher la propriété de service de fichiers du module Web d'hébergement en parcourant le fichier .war source dans un outil d'assemblage. Au besoin, mettez à jour la propriété et redéployez le module.
- Modifiez la propriété fileServingEnabled dans le fichier de configuration ibm-web-ext.xmi de l'application Web déployée.
Généralement, le fichier se trouve dans le répertoire racine_install/config/cells/nomdenoeud ou nomdenoeudNetwork/applications/nom_application/deployments/nom application/nom_module_Web/web-inf.
Généralement, le fichier se trouve dans le répertoire racine_profil/config/cells/nomdenoeud ou nomdenoeudNetwork/applications/nom_application/deployments/nom application/nom_module_Web/web-inf.
Les graphiques ne s'affichent pas sur la sortie du fichier JSP ou du servlet
Si la sortie texte s'affiche sur la page Web de votre JSP (ou servlet), mais que les fichiers d'images ne s'affichent pas :
- Verify that your graphic files are in the correct location: the document root directory of your
web application. Le produit respecte la norme J2EE,
qui exige que le répertoire principal des documents soit le répertoire nom_module_Web.war
de votre application Web déployée.
En général, le répertoire se trouve à l'emplacement racine_install/installedApps/nomnoeud/nomapplication.ear ou racine_installation/installedApps/nomnoeud/nomapplicationNetwork.ear.
En général, le répertoire se trouve dans le répertoire racine_profil/installedApps/nomdenoeud/nomapp.ear ou racine_profil/installedApps/nomdenoeud/nomappNetwork.ear.
If the graphics files are in a subdirectory of the document root, verify that the reference to the graphic reflects that; for example, if the banner.gif file is stored in Windows directory web_module_name.war/images, the tag to display it should read: <img SRC="banner.gif">, not <img SRC="banner.gif">.
- Pour vérifier que votre application Web est configurée pour activer
le service de fichiers (à savoir, l'affichage de ressources statiques telles que
des fichiers d'images et .html), procédez comme suit .
Afficher la propriété de service de fichiers du module Web d'hébergement en parcourant le fichier .war source dans un outil d'assemblage. Au besoin, mettez à jour la propriété et redéployez le module.
- Modifiez la propriété fileServingEnabled dans le fichier de configuration ibm-web-ext.xmi de l'application Web déployée.
Généralement, le fichier se trouve dans le répertoire racine_install/config/cells/nomdenoeud ou nomdenoeudNetwork/applications/nom_application/deployments/nom application/nom_module_Web/web-inf.
Généralement, le fichier se trouve dans le répertoire racine_profil/config/cells/nomdenoeud ou nomdenoeudNetwork/applications/nom_application/deployments/nom application/nom_module_Web/web-inf.
- Une fois l'étape précédente terminée :
- Dans la console d'administration, développez l'arborescence Environnement.
- Cliquez sur Mise à jour de l'extension WebSphere.
- Arrêtez et redémarrez le serveur HTTP, puis renouvelez la demande web.
SRVE0026E : [Erreur servlet]-[Compilation de classe impossible pour JSP
Si ce message d'erreur s'affiche dans un navigateur lors de la première tentative d'accès à un fichier .jsp nouveau ou modifié, il est probable que l'incident découle d'une erreur au niveau du source Java du fichier JSP (source incorrect) pendant la phase de compilation javac.
Vérifiez dans les fichiers journaux
si un message d'erreur ayant trait au compilateur s'est produit.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
C:\WASROOT\temp\ ... test.war\_myJsp.java:14: \Duplicate variable declaration: int myInt was int myInt
int myInt = 122;
String myString = "number is 122";
static int myStaticInt=22;
int myInt=121;
^
Rectifiez le fichier source JSP, sauvegardez-le, puis demandez à nouveau le fichier JSP.
Nom de variable ou de classe non défini : MaClasse
Cette
erreur indique qu'une classe ou un fichier jar de prise en charge n'a pas été copié sur le serveur cible ou ne se
trouve pas dans le chemin d'accès aux classes. Cherchez le fichier
MaClasse.class et placez-le dans le répertoire WEB-INF/classes du module web, ou placez son
fichier .jar dans le répertoire WEB-INF/lib du module web.Vérifiez que l'URL utilisée pour accéder à la ressource est correcte, en procédant comme suit :
- Pour un fichier JSP, un fichier html ou un fichier d'images : http://nom_hôte/racine_contexte_module_Web/sous-rép de racine
doc, éventuellement /nomfichier.ext. La racine des documents
d'une application Web est le répertoire nom_application.WAR de
l'application installée.
- Par exemple, pour accéder au fichier myJsp.jsp, se trouvant dans c:\WebSphere\ApplicationServer\installedApps\myEntApp.ear\myWebApp.war\invoices sur monhôte.mondomaine.com et en supposant que la racine du contexte du module Web monAppWeb est monApp, l'URL est http://monhôte.mondomaine.com/myApp/invoices/myJsp.jsp.
Le service de JSP est activé par défaut. Le service des fichiers HTML et des fichiers d'images doit être activé en tant que propriété du module web dans un outil d'assemblage ou en attribuant la valeur true à la propriété fileServingEnabled dans le fichieribm-web-ext.xmi de l'application web installée et en redémarrant l'application.
- L''URL des servlets servis par nom de classe est la suivante : http://nomhôte/racine_contexte_module_Web/servlet/NomModule.NomClasse.
Par exemple, l'URL permettant d'accéder au fichier maCom.monServlet.class, stocké dans c:\WebSphere\ApplicationServer\AppsInstallées\ monAppEnt.ear\monAppWeb.war\WEB-INF\classes, lorsque la racine de contexte du module monAppWeb est "monApp", est la suivante : http://monhôte.mondomaine.com/monApp/servlet/maCom.MonServlet.
Par exemple, l'URL permettant d'accéder au fichier maCom.monServlet.class, stocké dans racine_profil/AppsInstallées\monAppEnt.ear\monAppWeb.war\WEB-INF\classes, lorsque la racine de contexte du module monAppWeb est "monApp", est la suivante : http://monhôte.mondomaine.com/monApp/servlet/maCom.MonServlet.
Le service des servlets par nom de classe doit être activé en tant que propriété du module web, et l'est par défaut. Le service des fichiers HTML et des fichiers d'images doit être activé en tant que propriété de l'application web dans un outil d'assemblage ou en attribuant la valeur true à la propriété fileServingEnabled dans le fichieribm-web-ext.xmi de l'application web installée et en redémarrant l'application.
Rectifiez l'URL dans le fichier JSP, le servlet ou le fichier HTML indiqué à "from". Une HREF sans barre oblique (/) de fin a hérité du contexte de la ressource appelante. Par exemple :
- Une HREF dans http://[nomhôte]/monapp/servlet/MonServlet de ServletB est convertie en "http://nomhôte/monapp/servlet/ServletB"
- Une HREF dans http://[nomhôte]/monapp/servlet/MonServlet de "servlet/ServletB" est convertie en "http://nomhôte/monapp/servlet/servlet/ServletB" (erreur)
- Une HREF dans http://[nomhôte]/monapp/servlet/MonServlet de "/ServletB" est convertie en "http://nomhôte/ServletB" (erreur si ServletB nécessite la même racine de contexte que MonServlet)
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Après modification et sauvegarde d'un fichier JSP, les modifications n'apparaissent pas dans le navigateur
Il est probable que l'application web ne soit pas configurée pour le rechargement de servlet ou que l'intervalle de rechargement soit trop important.
Pour résoudre cet incident dans un outil d'assemblage, vérifiez l'état de l'option Rechargement autorisé et la valeur de l'option Intervalle de rechargement dans les extensions IBM pour le module Web concerné. Activez le rechargement ou, s'il l'est déjà, réduisez l'intervalle de rechargement.
Message d'erreur : /jspname.jsp(9,0) Include : page d'attribut obligatoire manquante
L'erreur "Message : /jspname.jsp(9,0) Include : page d'attribut obligatoire manquante" s'affiche en cas de tentative de parcours du fichier JSP
Le fichier JSP a peut-être échoué lors de la conversion en phase Java. Plus précisément, une directive JSP, ici une instruction Include, incorrecte ou faisant référence à un fichier introuvable.
Pour résoudre cet incident, rectifiez la source JSP, sauvegardez-la, puis demandez à nouveau le fichier JSP.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
La source Java générée à partir d'un fichier JSP n'est pas conservée dans le répertoire temporaire
Il est probable que le processeur JSP n'est pas configuré pour conserver le source Java.
Dans un outil d'assemblage, vérifiez les attributs JSP sous Extensions des propriétés d'assemblage pour le module Web concerné. Vérifiez que l'attribut keepgenerated existe et a été défini à true. Si tel n'est pas le cas, définissez cet attribut et redémarrez l'application web. Pour afficher les résultats de cette opération, supprimez le fichier classe du répertoire temp pour forcer le processeur JSP à convertir à nouveau le source JSP en Java.
Erreur "Application Enterprise [nom de l'application que vous avez entré] introuvable"
Le compilateur JSP par lots échoue avec le message "Application Enterprise [nom d'application que vous avez entré] introuvable."
Il est probable que le chemin et le nom complet de l'application d'entreprise, commençant par le sous-répertoire .ear du répertoire applications doit être un argument de l'outil JspBatchCompiler et pas uniquement le nom d'affichage.
Le chemin du répertoire est racine_install\config\cells\nom_noeudNetwork\applications.
Le chemin du répertoire est racine_profil/config/cells/nom_noeudNetwork/applications.
Par exemple :
- "JspBatchCompiler -enterpriseapp.name sampleApp.ear/deployments/sampleApp" est correct, tandis que
- "JspBatchCompiler -enterpriseapp.name sampleApp" ne l'est pas.
Problème de conversion des entrées du navigateur qui ne sont pas en anglais
req.setCharacterEncoding("gb2312");avant tout appel de méthode req.getParameter().
Cet incident affecte les servlets et les fichiers jsp portés depuis des versions antérieures de WebSphere Application Server, qui convertissent automatiquement les caractères en fonction des paramètres régionaux de WebSphere Application Server.
Les barres de défilement ne s'affichent pas autour des éléments dans la fenêtre du navigateur
Dans certains navigateurs, les éléments de type arborescence ou liste qui s'étendent derrière la fenêtre qui leur est allouée ne disposent pas de barres de défilement permettant de visualiser la totalité de la liste.
Pour résoudre cet incident, cliquez à l'aide du bouton droit de la souris dans la fenêtre du navigateur, puis sélectionnez Rechargement dans le menu.
Erreur "Impossible d'afficher la page ; serveur introuvable ou erreur DNS"
Erreur "Impossible d'afficher la page, Serveur introuvable ou Erreur DNS" lors de la tentative de consultation d'une page JSP (JavaServer Pages Page) à l'aide d'Internet Explorer
Cette erreur peut survenir lorsque l'objet serviteur est arrêté, puis redémarré, suite à un délai d'expiration HTTP. Pour résoudre cet incident, augmentez la valeur du paramètre ConnectionIOTimeOut :
- Dans la console d'administration, sélectionnez Administration système Gestionnaire de déploiement Services d'administration Propriétés personnalisée
- Sélectionnez ConnectionIOTimeOut.
- Augmentez la valeur du paramètre ConnectionIOTimeOut.
- Cliquez sur OK.
![[z/OS]](../images/ngzos.gif)
L'exception DeploymentDescriptorLoadException apparaît lors du démarrage d'une application
Si un serveur d'applications sur lequel l'application est déployée, synchronise la configuration avec le gestionnaire de déploiement pendant le démarrage du serveur, l'application risque de ne pas démarrer et une exception DeploymentDescriptorLoadException peut être consignée dans le fichier SystemErr.log du serveur. Arrêtez, puis redémarrez le serveur. Puis essayez de redémarrer l'application.