Avant de commencer à identifier et à résoudre les incidents de l'application IBM Telephone Directory version 5.2, répondez aux questions ci-dessous pour parvenir à résoudre les incidents les plus courants lors de l'utilisation de l'application :
Si l'incident persiste, utilisez les informations suivantes :
Identification et résolution des incidents liés à la configuration
Incident | Cause | Solution |
L'installation a échoué en générant le message : ldap_search: Insufficient access | Vous avez entré un mot de passe administrateur incorrect pour accéder au serveur LDAP. | Procurez-vous un mot de passe valide ou redéfinissez le mot de passe. |
Le script de configuration a échoué en générant les messages suivants : ldap_search: No such object Error 32 verifying LDAP settings | L'incident est peut-être dû à l'absence de nom distinctif de base sur le serveur LDAP. | Il y a peut-être une erreur dans la configuration du serveur LDAP de base. |
Identification et résolution des incidents liés à l'authentification
Incident | Cause | Solution |
La connexion échoue | Dans l'application, les ID utilisateur et les mots de passe doivent comporter des caractères mappés au CCSID du travail utilisé par le serveur HTTP. Dans le cas contraire, l'authentification échoue. | Assurez-vous que les caractères sont mappés au CCSID du travail utilisé par le serveur HTTP. Pour déterminer le CCSID du travail utilisé par le serveur HTTP, entrez WRKACTJOB à partir de la ligne de commande OS/400 et sélectionnez Display job definition attributes. Le CCSID du serveur HTTP est déterminé par la directive defaultFSCCSID associée. Pour plus d'informations, voir Remarques et limitations. |
L'URL échoue ou l'application n'apparaît pas | Si vous n'avez pas lancé l'application IBM Welcome Page, l'adresse URL échoue (http://nom.du.serveur:port/ibm-bizApps/welcome-home.do ou http://nom.du.serveur:port/ibm-bizApps/welcome-admin.do). Des incidents se produisent également si vous lancez l'application IBM Welcome Page sans lancer l'application IBM Telephone Directory. Si l'application IBM Telephone Directory n'est pas en cours d'exécution, l'application IBM Welcome Page n'affiche pas de liens pour y accéder. | Lancez l'application IBM Welcome Page et l'application IBM Telephone Directory. |
Les demandes transmises à l'application échouent | Si vous avez utilisé le serveur HTTP interne fourni avec WebSphere Application Server pour référencer l'application IBM Telephone Directory version 5.2, certaines demandes adressées à l'application échouent. | Vous devez impérativement utiliser le système IBM HTTP Server pour référencer l'application. Les directives de sécurité définies pour l'authentification du serveur LDAP sont configurées et requises par l'application IBM Telephone Directory lors de la création d'une instance du serveur d'applications. Le serveur HTTP interne de WebSphere Application Server n'est pas configuré avec les directives de sécurité nécessaires et certaines demandes adressées à l'application échouent si le serveur HTTP interne est utilisé. Pour plus d'informations, voir Interaction avec le système IBM HTTP Server. |
Identification et résolution des incidents lors de l'utilisation
Incident | Cause | Solution |
Lien manquant pour accéder à l'application | L'adresse URL http://nom.du.serveur:port/ibm-bizApps/welcome/home.do permet d'accéder au point d'entrée du logiciel IBM Business Solutions, notamment à l'application IBM Telephone Directory version 5.2. | Si le lien d'accès à l'application IBM Telephone Directory version 5.2 est manquant, assurez-vous que les applications IBM Welcome Page et IBM Telephone Directory sont lancées. |
Confusion liée à l'ID d'administration | Il est parfois difficile de déterminer l'ID utilisateur à indiquer pour s'authentifier auprès de l'application lorsque vous (administrateur) devez mettre à jour ou enregistrer un utilisateur dans un environnement avec enregistrement en mode fermé. | L'ID utilisateur par défaut est Administrator et le mot de passe est configuré lors de l'installation. N'entrez pas d'ID utilisateur ni de mot de passe personnel. Les ID utilisateur de l'application peuvent être visualisés par tous. Si vous ne connaissez pas l'ID utilisateur d'une entrée, utilisez la page de recherche de l'application pour rechercher l'entrée. L'ID utilisateur s'affiche sous la photo. |
Erreur liée au serveur interne lors d'une recherche ou d'un enregistrement | Si vous tentez de rechercher ou d'enregistrer un utilisateur et que vous recevez une erreur de type "Erreur HTTP 500 - Serveur interne", il est possible que les fichiers d'installation soient altérés. L'application IBM Telephone Directory version 5.2 risque de ne pas trouver les fichiers de configuration associés. | Réinstallez l'application IBM Telephone Directory version 5.2. |
Erreur système lors de la recherche | Si vous tentez de rechercher un utilisateur et recevez une erreur de type Une erreur système s'est produite. Faites une nouvelle tentative, il est possible que le serveur LDAP n'ait pas été démarré. | Démarrez le serveur LDAP et faites une nouvelle tentative. |
Erreur liée à l'échec d'une opération lors d'un enregistrement | Si vous tentez d'enregistrer un utilisateur et recevez une erreur de type ERREUR : Echec de l'opération. Adressez-vous à l'administrateur d'IBM Telephone Directory, il est probable que le serveur LDAP n'a pas été démarré. | Démarrez le serveur LDAP et faites une nouvelle tentative. |
Erreur liée à l'échec d'une opération lors de mise à jour ou de suppression d'une entrée | Si vous tentez de mettre à jour ou de supprimer un profil et recevez un message d'erreur de type ERREUR : Echec de l'opération. Adressez-vous à l'administrateur d'IBM Telephone Directory, il est possible que les directives appropriées n'aient pas été configurées sur le serveur HTTP. Un symptôme de cet incident est l'absence de fenêtre d'authentification pour entrer l'ID utilisateur et le mot de passe avant d'effectuer des modifications. | Ajoutez manuellement les directives de configuration LDAP manquantes à la configuration du serveur HTTP ou réinstallez l'application IBM Telephone Directory version 5.2. |
Erreur liée à un objet manquant | Si vous recevez une erreur de type "Erreur 404 - Objet introuvable" dans l'application IBM Telephone Directory, il est possible que le fichier plugin-cfg.xml soit endommagé. | Pour vérifier le fichier et éventuellement le corriger, procédez comme suit :
|
Erreur liée au dépassement du nombre maximal de profils | IBM Telephone Directory est un programme gratuit capable de gérer jusqu'à 1000 entrées d'utilisateurs. Le serveur d'annuaires LDAP doit être configuré afin que le nombre d'entrées autorisées lors d'une recherche dans le nom distinctif de base d'IBM Telephone Directory soit supérieur ou égal à 1000. | Pour plus d'informations sur le nombre maximal d'entrées d'utilisateurs voir Remarques et limitations. |
Valeurs non sauvegardées | Si vous tentez d'ajouter, de modifier ou de supprimer la valeur d'une zone de l'application sans disposer des droits appropriés, un message s'affiche pour indiquer que certaines valeurs n'ont pas été sauvegardées car l'annuaire ne vous autorise pas à les ajouter au profil et vous invite à contacter l'administrateur de l'application pour obtenir plus d'informations. | Si vous recevez cette erreur, l'authentification requise a été configurée dans l'application IBM Telephone Directory version 5.2. |
Les caractères spéciaux (tels que ", &, < ou >) ne sont pas traités correctement. | L'application IBM Telephone Directory version 5.2 a été conçue pour accepter et traiter tous les caractères, même les caractères spéciaux (ou métacaractères) pour HTML, JavaScript, les filtres LDAP ou les valeurs d'attribut. | Dans certains cas, l'application IBM Telephone Directory version 1.1 prend en charge correctement les caractères des valeurs d'attribut LDAP, conformément à la norme RFC 2253. Toutefois, le serveur d'annuaires ne prend pas intégralement en charge cette norme. Dans ce cas, la seule solution consiste à éviter d'utiliser ce type de caractères. Prenons le caractère apostrophe (") comme exemple. La norme RFC 2253 indique que le caractère d'échappement doit être précédé d'une barre oblique (\) pour être accepté en tant que caractère littéral dans la valeur d'attribut LDAP. Comme la dernière version du serveur LDAP Directory Services ne prend pas en charge l'intégralité de la norme RFC 2253, le serveur sauvegarde à la fois le caractère oblique et le caractère apostrophe. |
Consignation des erreurs et débogage
Journaux des erreurs
Le serveur d'applications dispose d'une série de journaux dans lesquels les messages sont consignés. Par exemple, les messages système, qui peuvent être consignés par n'importe quel composant du serveur d'applications ou n'importe quelle application, sont consignés dans les journaux généraux, tels que les journaux de la machine virtuelle Java ou les journaux de service IBM. Les autres journaux sont spécifiques et s'appliquent à un composant ou à une activité particulière. Par exemple, le plug-in d'IBM HTTP Server gère un journal propre au composant.
Les journaux généraux, tels que les journaux de la machine virtuelle Java ou du service IBM, sont utilisés pour surveiller le fonctionnement du serveur d'applications et vous aider lors de l'identification et la résolution des incidents. L'identification et la résolution des incidents liés à des composants spécifiques peuvent nécessiter l'analyse de journaux supplémentaires, tels que les journaux propres à un produit ou à un composant.
Instructions de trace
Vous pouvez activer les instructions de trace de l'application pour déboguer les erreurs. Si les erreurs persistent et que vous devez faire appel au service d'assistance d'IBM, il est possible que vous deviez leur fournir une copie des données de trace de l'application. Pour activer les instructions de trace, ajoutez une ligne au fichier de configuration de l'application et relancez l'application.
L'application lit la nouvelle configuration lors de son lancement. L'instruction de trace d'application est activée lors de ce processus. Une fois activées, les instructions de trace sont consignées dans le fichier SystemOut.log du serveur.