在开始对 IBM Telephone Directory V5.2 应用程序的问题进行故障诊断前,请回答以下问题以帮助解决使用该应用程序时的某些常见问题:
如果应用程序仍然有问题,请使用以下信息:
故障诊断设置
问题 | 原因 | 解决方案 |
安装失败,出现以下消息:ldap_search: 访问条件不够 | 输入了错误的 LDAP 服务器管理员密码。 | 获取正确的密码或重置密码。 |
设置脚本失败,出现以下消息: ldap_search: 没有这种对象(错误 32 正在验证 LDAP 设置) | 问题出在 LDAP 服务器上不存在基本 DN。 | 基本 LDAP 服务器配置可能有问题。 |
故障诊断认证
问题 | 原因 | 解决方案 |
登录失败 | 在该应用程序中,用户标识和密码必须包含映射到 HTTP 服务器使用的作业 CCSID 的字符。否则,认证将失败。 | 请确保您的字符映射到 HTTP 服务器使用的作业 CCSID。要确定 HTTP 服务器的作业 CCSID,请在 OS/400 命令行输入 WRKACTJOB,并选择显示作业定义属性。HTTP 服务器 CCSID 由 HTTP 服务器 defaultFSCCSID 伪指令确定。要获取更多信息,请参阅声明和限制。 |
URL 失败或者应用程序不出现 | 如果未启动 IBM Welcome Page 应用程序,则 URL 失败(http://your.server.name:port/ibm-bizApps/welcome-home.do 或 http://your.server.name:port/ibm-bizApps/welcome-admin.do)。如果启动了 IBM Welcome Page 应用程序但未启动 IBM Telephone Directory 应用程序,也会发生问题。如果 IBM Telephone Directory 应用程序未在运行,则 Welcome Page 应用程序没有到它的链接。 | 启动 IBM Welcome Page 应用程序和 IBM Telephone Directory 应用程序。 |
到应用程序的请求失败 | 如果使用与 WebSphere Application Server 包含在一起的内部 HTTP 服务器以引用 IBM Telephone Directory V5.2 应用程序,则到该应用程序的特定请求失败。 | 您必须使用关联的 IBM HTTP 服务器以引用该应用程序。LDAP 服务器认证的安全伪指令在创建新的应用程序服务器实例期间设置,并且 IBM Telephone Directory 应用程序需要这些指令。WebSphere Application Server 的内部 HTTP 服务器未设置必需的安全伪指令,如果使用了内部 HTTP 服务器,则到该应用程序的特定请求失败。请参阅与 IBM HTTP 服务器的交互作用以获取更多信息。 |
故障诊断用法
问题 | 原因 | 解决方案 |
缺少到该应用程序的链接 | URL http://your.server.name:port/ibm-bizApps/welcome/home.do 将带您到 IBM Business Solutions 以及 IBM Telephone Directory V5.2 应用程序的入口点。 | 如果缺少到 IBM Telephone Directory V5.2 应用程序的链接,则检查以确保 IBM Welcome Page 应用程序和 IBM Telephone Directory 应用程序都已启动。 |
管理用户标识混淆 | 当您(管理员)需要在关闭的登记环境中更新或注册用户时,对于应该输入哪个用户标识来认证应用程序可能会觉得迷惑。 | 缺省用户标识是管理员,密码在安装期间设置。不要输入您的个人用户标识和密码。每个人始终都可以查看应用程序用户标识。如果不知道条目的用户标识,则使用应用程序的搜索页面来查找该条目。用户标识显示在图片下。 |
搜索或注册期间发生内部服务器错误 | 如果尝试搜索用户或注册用户,并得到了 HTTP 500 - 内部服务器错误,则这可能意味着您的安装文件已毁坏。IBM Telephone Directory V5.2 应用程序可能无法找到该应用程序关联的配置文件。 | 重新安装 IBM Telephone Directory V5.2 应用程序。 |
搜索期间发生系统错误 | 如果尝试搜索用户并获取了以下错误:发生了系统错误!请稍后再试,则这通常意味着 LDAP 服务器尚未启动。 | 启动 LDAP 服务器,然后再尝试搜索。 |
注册期间发生操作失败错误 | 如果尝试注册用户并获取了以下错误:错误:操作失败。请联系您的 IBM Telephone Directory 应用程序管理员,则这通常意味着 LDAP 服务器尚未启动。 | 启动 LDAP 服务器,然后再尝试注册。 |
条目更新或删除期间发生操作失败错误 | 如果尝试更新或删除概要文件并获取了以下错误:错误:操作失败。请联系您的 IBM Telephone Directory 应用程序管理员,则您可能未在 HTTP 服务器中配置适当的伪指令。此问题的某个症状是:进行更改前,缺少要输入用户标识和密码的认证对话。 | 将缺少的 LDAP 配置伪指令手工添加到 HTTP 服务器配置,或重新安装 IBM Telephone Directory V5.2 应用程序。 |
对象未找到错误 | 如果在 IBM Telephone Directory 应用程序中接收到 404 - 对象未找到错误,则可能是因为您的 plugin-cfg.xml 文件毁坏了。 | 必要的话,执行以下步骤以检查此文件并修订它:
|
超出最大概要文件的错误 | IBM Telephone Directory 是免费程序,最多可以有 1000 个用户条目。必须配置 LDAP 目录服务器,以使 IBM Telephone Directory 的基本 DN 中可允许的搜索条目数不小于 1000。 | 要获取有关 1000 个用户条目限制的更多信息,请参阅声明和限制。 |
未保存某些值 | 如果没有权限添加、更改或除去特殊字段,而尝试在应用程序中执行此操作,则将接收到未保存某些值的声明,因为该目录不允许您将它们添加到概要文件中,请联系应用程序管理员以获取详细信息。 | 如果接收到此错误,则意味着已经在 IBM Telephone Directory V5.2 应用程序上配置了必需的认证。 |
未正确处理特殊字符(例如 "、&、< 或 >) | 已将 IBM Telephone Directory V5.2 应用程序写为正确接受和处理所有字符,即使是那些识别为 HTML、JavaScript 和 LDAP 过滤器的特殊字符(或元字符)以及属性值。 | 根据 RFC 2253 标准,在某些情况下 IBM Telephone Directory 应用程序可以正确处理 LDAP 属性值的特殊字符。然而,目录服务器不完全支持该标准。对于这些情况,除了避免使用这种字符外,别无他法。 引号(")字符是此问题的一个示例。RFC 2253 标准规定可以通过以下方法来避免该字符:通过在该字符前面加上反斜杠(\),从而将它接受为 LDAP 属性值中的文字字符。因为当前版本的目录服务(LDAP)不完全支持 RFC 2253,所以服务器将保存反斜杠字符和引号字符。 |
错误记录和调试
错误日志
应用程序服务器有写消息的各种日志。例如,可以由任何应用程序服务器组件或应用程序写的系统消息将写入通用目的的日志(例如 JAVA Virtual Machine(JVM)日志和 IBM Service 日志)中。其它日志实际上是非常特定的,作用域为特殊组件或活动。例如,HTTP Server 插件维护特定于组件的插件日志。
通用日志(例如 JVM 和 IBM Service)用于监控应用程序服务器的运行状况并辅助故障诊断。对特定组件进行故障诊断可能需要其它日志分析,例如特定于组件或产品的日志文件。
跟踪语句
可以启用应用程序跟踪语句以调试问题。如果问题仍然存在,那您就必须呼叫 IBM Service 以获取帮助,他们可能会首先向您索取应用程序跟踪输出的副本。通过将一行添加到应用程序的配置文件,然后重新启动该应用程序来启用跟踪语句。
应用程序将在启动时读取新的配置。应用程序跟踪语句将在此时启用。启用后,跟踪语句将写入服务器的 SystemOut.log 文件。