WebSphere WebSphere Enterprise Service Bus V6.0.1 操作系统: AIX, HP-UX, Linux, Solaris, Windows

对安装进行故障诊断

如果在安装 WebSphere ESB 时遇到了问题,就可以使用许多活动和工具来对问题进行故障诊断并解决它。

执行此任务的目的和时间

使用本主题来诊断在安装不成功时可能存在的问题。安装程序会在主日志文件末尾记录下列表示安装成功的指示符,可以在 install_root/logs/wbi/log.txt(在 Linux 和 UNIX 平台上)或者 install_root\logs\wbi\log.txt(在 Windows 平台上)中找到这些指示符: 如果结果为 INSTCONFPARTIALSUCCESSINSTCONFFAILED,则通过执行下列步骤来继续分析存在的问题:

完成此任务需要执行的步骤

  1. 如果安装过程显示了任何错误消息,则检查错误消息:安装、概要文件的创建和扩充以获取对错误的说明。

    如果显示的消息与所描述的任何一种情况相符,则修正该问题,并清除任何已安装的部分,然后尝试重新进行安装。

    有关在重新安装之前卸载任何仍未被卸载部分的详细信息,请参阅在卸载失败之后准备重新安装

  2. 确定 WebSphere Application Server Network Deployment 的安装是否成功。 如果 WebSphere ESB 的安装不成功,则首先检查 install_root/logs/log.txt(在 Linux 和 UNIX 平台上)或者 install_root\logs\log.txt(在 Windows 平台上)以了解发生的错误,从而确定 WebSphere Application Server Network Deployment 的安装是否成功。
    • 如果 WebSphere Application Server Network Deployment 的安装失败,则复查 WebSphere Application Server Network Deployment 的有关对安装进行故障诊断的信息。使用在该节中找到的信息来修正问题之后才尝试重新安装 WebSphere ESB
    • 如果 WebSphere Application Server Network Deployment 的安装成功,而 WebSphere ESB 的安装失败,则使用以下故障诊断信息来修正问题。
  3. 在安装之后,检查 WebSphere ESB 安装日志文件以了解发生的错误。

    请参阅日志文件以获取已创建的各种日志文件的名称、位置和描述。按以下顺序检查日志文件:

    LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:
    1. install_root/logs/wbi
    2. %tmp%(如果在 install_root/logs/wbi 中未找到任何文件的话)
    3. install_root/logs/wasprofile/wasprofile_create_ profile_name.log install_root/logs/wasprofile/wasprofile_augment_ profile_name.log。如果执行了完整安装(它将创建一个名为 default 的独立服务器),则 profile_name 的值将为 default
    4. 由安装操作生成的任何其他日志文件或跟踪文件。查看 install_root/logs/wbi,以获取在安装(或卸载)过程中生成的跟踪文件。查看 profile_root/logs,以获取由概要文件创建或扩充所生成的那些日志文件。其中 profile_root 表示 WebSphere ESB 概要文件的安装位置(缺省情况下,在 Linux 和 UNIX 平台上,其值为 install_root/profiles/profile_name)。这些文件只要供 IBM 技术支持人员使用。
    For Windows platforms 在 Windows 平台上:
    1. install_root\logs\wbi
    2. %tmp%(如果在 install_root\logs\wbi 中未找到任何文件的话)
    3. install_root\logs\wasprofile\wasprofile_create_ profile_name.log install_root\logs\wasprofile\wasprofile_augment_ profile_name.log。如果执行了完整安装(它将创建一个名为 default 的独立服务器),则 profile_name 的值将为 default
    4. 由安装操作生成的任何其他日志文件。查看 install_root\logs\wbi,以获取在安装(或卸载)过程中生成的跟踪文件。查看 profile_root\logs,以获取由概要文件创建或扩充所生成的那些日志文件。其中 profile_root 表示 WebSphere ESB 概要文件的安装位置(缺省情况下,在 Windows 平台上,其值为 install_root\profiles\profile_name)。这些文件只要供 IBM 技术支持人员使用。
  4. 如果安装日志中不存在任何信息,则将 -log 参数与响应文件配合使用。
    某些事件可能会阻止 InstallShield for Multiplatforms(ISMP)启动安装向导。以下是这类事件的一个示例:没有足够的磁盘空间来启动安装向导。如果安装失败并且安装日志中未提供任何信息,请将 -log 参数与响应文件配合使用来记录导致 ISMP 程序未能启动安装向导的事件条目。 这将使用下列任何一个响应文件:
    • responsefile.esb.txt
    • responsefile.pcaw.esb.standAloneProfile.txt
    • responsefile.pcaw.esb.dmgrProfile.txt
    • responsefile.pcaw.esb.managedProfile.txt

    有关这些响应文件的更多信息,请参阅以静默方式安装 WebSphere ESB

    需要将响应文件从 WebSphere ESB CD 1 复制到系统的硬盘驱动器中以使用它。用于记录这些事件的 install 命令的语法与下列示例相似(您的响应文件和日志文件的路径以及响应文件的实际名称可能有所不同):

    For AIX platforms 在 AIX 平台上:
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    LINUX platforms Solaris platforms 在 HP-UX、Linux 和 Solaris 平台上:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    For Windows platforms 在 Windows 平台上:
    install.exe -options "C:\IBM\WebSphere\silentFiles\myresponsefile.txt" 
                -silent -log # !C:\IBM\WebSphere\silentFiles\log.txt  @ALL
  5. 确定是否是已失败的配置脚本导致了安装问题。

    install_root/logs/wbi/instconfig.log 文件(在 Linux 和 UNIX 平台上)或 install_root\logs\wbi\instconfig.log 文件(在 Windows 平台上)表示可能会妨碍产品正确工作的配置问题。对字符串 action failed 进行搜索,以查找失败的配置脚本的名称。

  6. 验证 install_root/classes 目录中是否不存在任何文件。

    IBM 支持机构有时会将客户的工作排队并提供测试或调试修订。这些修订通常放置在 install_root/classes 目录中。

    缺省情况下,WebSphere ESB 类路径中将首先采用 install_root/classes 目录,以让它覆盖其他类。

    通过将修订放入目录中就可以验证该修订是否真正解决了问题。在验证修订确实解决了问题之后,应从 install_root/classes 目录中删除该修订,以使系统恢复工作状态。

    如果不从 install_root/classes 目录中除去这些修订,则可能会发生错误。

  7. 如果错误日志中没有足够的信息可用来确定产生问题的原因,则可以卸载产品、清除其余的任何日志文件或其他工件,并在打开跟踪之后重新安装。
    • 通过对 install 命令添加 -is:javaconsole 参数来将 stdoutstderr 日志显示在控制台窗口上:
      • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:
        install -is:javaconsole
        使用下列命令来捕获文件的流:
        install -is:javaconsole > captureFileName.txt 2>&1
      • For Windows platforms 在 Windows 平台上:
        install.exe -is:javaconsole
        使用下列命令来捕获文件的流:
        install.exe -is:javaconsole > drive:\captureFileName.txt
    • 使用 -is:log file_name 选项来将其他信息捕获到您选择的日志中。
    • 通过对 install 命令附加 -W Setup.product.install.logAllEvents="true" 参数来打开其他安装日志记录:
      • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:
        install -W Setup.product.install.logAllEvents="true"
      • For Windows platforms 在 Windows 平台上:
        install.exe -W Setup.product.install.logAllEvents="true"
  8. 如果已经成功创建了服务器概要文件,则使用“第一步”控制台或者命令行方法来启动服务器。
    对特定节点启动“第一步”控制台(其中 profile_root 表示 WebSphere ESB 概要文件的安装位置(缺省情况下,其值为 install_root/profiles/profile_name(在 Linux 和 UNIX 平台上)或者 install_root\profiles\profile_name(在 Windows 平台上)):
    • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上: profile_root/firststeps/esb/firststeps.sh
    • For Windows platforms 在 Windows 平台上: profile_root\firststeps\esb\firststeps.bat
    从命令行启动服务器:
    1. 将目录切换至概要文件中的 profile_root/bin 目录。
    2. 启动服务器进程。
      • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上: ./startServer.sh server_name
      • For Windows platforms 在 Windows 平台上: startServer.bat server_name
  9. 通过在 SystemOut.logSystemErr.log 文件中查找正在运行的 Java 进程和 Open for e-business 消息来验证是否正确启动并装入了服务器。

    如果不存在 Java 进程或者未出现该消息,则检查相同的日志以找出各种各样的错误。更正任何错误,然后重试。

    可以在下列特定于平台的目录中找到 SystemOut.logSystemErr.log 文件:
    • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上: profile_root/logs/server_name
    • For Windows platforms 在 Windows 平台上: profile_root\profiles\logs\server_name
  10. 使用“第一步”控制台或命令行方法来停止 server_name 服务器(如果该服务器正在运行)和启动部署管理器(如果存在一个部署管理器)。
    要从命令行停止 server_name
    • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上: profile_root/bin/stopServer.sh server_name
    • For Windows platforms 在 Windows 平台上: profile_root\bin\stopServer.bat server_name
    如果启用了安全性,则指定该命令的 -user 和 -password 参数。
    要从命令行启动部署管理器:
    • LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上: profile_root/bin/startManager.sh
    • For Windows platforms 在 Windows 平台上: profile_root\bin\startManager.bat
  11. 通过在 profile_root/logs/server_name/SystemOut.log 文件中查找正在运行的 Java 进程和 Server dmgr open for e-business 消息来验证是否正确启动并装入了服务器。
    LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:打开命令窗口并发出 top 命令来查看正在运行的进程的显示。如果系统上未提供 top 命令,则使用 ps 命令。
    ps -ef | grep java

    For Windows platforms 在 Windows 平台上:Ctrl+Alt+Delete,然后输入 T 来打开“任务管理器”。单击进程选项卡和图像名称列标题,以按图像名称进行排序。查找名为 java.exe 的进程。

    如果不存在 Java 进程或者未出现该消息,则检查相同的日志以找出各种各样的错误。更正任何错误,然后再次尝试启动部署管理器。

下一步做什么?

要从 IBM 支持 Web 站点上获取关于已知问题及其解决方案的最新信息,请参阅 IBM WebSphere ESB 支持 页面。


任务主题

使用条款 | 评价此页

Timestamp icon上次更新时间: 3 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\doc\tins_trouble.html

(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)