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 ?

La remarque suivante s'applique aux références ibm-web-ext.xmi tout au long de cette rubrique :
Configurations prises en charge Configurations prises en charge: Pour les fichiers de liaison et d'extension IBM®, l'extension de nom de fichier .xmi ou .xml est différente selon que vous utilisiez un module ou une application antérieure à Java EE 5 ou un module ou une application ultérieure à Java™ EE 5. Un fichier de liaison ou d'extension IBM porte le nom ibm-*-ext.xmi ou ibm-*-bnd.xmi où * correspond au fichier d'extension ou de liaison, tel app, application, ejb-jar ou web. Les conditions suivantes s'appliquent :
  • Pour une application ou un module qui utilise une version Java EE antérieure à la version 5, l'extension de fichier doit être .xmi.
  • Pour une application ou un module qui utilise Java EE 5 ou version ultérieure, l'extension de fichier doit être .xml. Si des fichiers .xmi sont inclus dans l'application ou le module, le produit les ignore.

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.

sptcfg

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

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 :

  1. Déterminez si le serveur HTTP tente de servir lui-même la ressource demandée au lieu de la transmettre à WebSphere Application Server.
    1. 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.
    2. Parcourez le fichier journal du plug-in.
  2. 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.

      [IBM i]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.

    [IBM i]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.

  3. 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.
  4. 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.

    [AIX Solaris HP-UX Linux Windows][z/OS]En général, le répertoire se trouve à l'emplacement racine_install/installedApps/nomnoeud/nomapplication.ear ou racine_installation/installedApps/nomnoeud/nomapplicationNetwork.ear.

    [IBM i]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 :
    1. 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.

    2. Modifiez la propriété fileServingEnabled dans le fichier de configuration ibm-web-ext.xmi de l'application Web déployée.

      [AIX Solaris HP-UX Linux Windows][z/OS]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.

      [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]En général, le répertoire se trouve à l'emplacement racine_install/installedApps/nomnoeud/nomapplication.ear ou racine_installation/installedApps/nomnoeud/nomapplicationNetwork.ear.

    [IBM i]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 .
    1. 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.

    2. Modifiez la propriété fileServingEnabled dans le fichier de configuration ibm-web-ext.xmi de l'application Web déployée.

      [AIX Solaris HP-UX Linux Windows][z/OS]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.

      [IBM i]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.

    3. 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.

[z/OS]Vérifiez dans les fichiers journaux si un message d'erreur ayant trait au compilateur s'est produit.

[AIX Solaris HP-UX Linux Windows][IBM i]Vérifiez si le fichier SystemErr.log contient un message d'erreur ayant trait au compilateur, tel que :
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; 
      ^
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.

Rectifiez le fichier source JSP, sauvegardez-le, puis demandez à nouveau le fichier JSP.

Si l'erreur se produit lorsque vous tentez de servir un fichier JSP copié à partir d'un autre système sur lequel il s'exécutait correctement, il est probable que l'incident vienne d'une différence entre les deux environnements de serveur. Recherchez dans le texte du message d'erreur une instruction du type :
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.

    [AIX Solaris HP-UX Linux Windows]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.

    [IBM i]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][IBM i]

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][IBM i]

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.

[AIX Solaris HP-UX Linux Windows]Le chemin du répertoire est racine_install\config\cells\nom_noeudNetwork\applications.

[IBM i]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

Si les entrées du navigateur qui ne sont pas en anglais ne peuvent pas être converties après lecture par un servlet ou un JSP, vérifiez que les paramètres requis sont codés dans le jeu de caractères escompté avant lecture. Par exemple, si le site est chinois, le fichier cible .jsp doit comporter une ligne :
 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 :

  1. Dans la console d'administration, sélectionnez Administration système Gestionnaire de déploiement Services d'administration Propriétés personnalisée
  2. Sélectionnez ConnectionIOTimeOut.
  3. Augmentez la valeur du paramètre ConnectionIOTimeOut.
  4. Cliquez sur OK.
[z/OS]

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.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_pagedisplayprob2
Nom du fichier : rtrb_pagedisplayprob2.html