IBM Business Process Manager (BPM)产品安装及升级问题需要收集的故障诊断数据

Resolving The Problem

在寻求BPM技术支持团队的帮助之前，您可以通过以下电子资源，来查看是否有现成的解决方案：

• 使用消息号（message number）或者错误码（error codes）在下面列表对应的产品支持站点进行搜索，看是否是已知问题：
• IBM Business Process Manager Standard
• IBM Business Process Manager Express
• IBM Business Process Manager Advanced
• IBM Business Process Manager Advanced for z/OS
  
  
• 使用 IBM Support Assistant 可以在 information center，论坛和technotes中搜索已知问题.
• 也可以在IBM Business Process Manager developerWorks community 中搜索已知问题.
• 如果您发现IBM已经发布了补丁(fix)修复该问题, 您可以在 Fix Central 中查找相应的临时补丁(interim fix)并下载安装.

本文档包含以下部分内容：

• 收集所有安装及升级问题的一般信息
• 收集启动面板相关问题的数据
• 收集产品安装和升级相关问题的数据

• 产品信息和日志
• Installation Manager 数据
• 概要文件(Profiles)日志
• 数据库升级日志
• 启用IBM Installation Manager trace
• 其他故障排除提示和技巧

收集所有安装及升级问题的通用信息
首先请您提供您所遇到问题的详细描述，包括以下几个部分：

• 您正在使用的BPM产品的详细版本，以及补丁包
• 您正在使用的操作系统版本以及补丁包
• 您正在使用的数据库类型及版本

提供您安装产品时所参照的URL链接或者文档
根据您所遇到的问题的类型，请基于本文件中的以下部分内容，收集更多具体问题的信息

收集启动面板相关问题的数据
与启动面板的相关问题，请提供以下信息：

• 请说明该问题第一次发生的时间。包括您操作的详细步骤以及您所执行的导致问题发生的命令
• 请提供问题发生时的屏幕截图
• 请收集下列目录中的日志文件

<Temp_Dir>\x\IBM_Launchpadxxxxx
<Temp_Dir>\ IBM_LaunchPad_Typical_Install_#####

例如：
C:\Documents and Settings\user\Local Settings\Temp\1\
IBM_LaunchPad_20152
C:\Users\ADMINI~1\AppData\Local\Temp\1\IBM_LaunchPad_BPM_1322801669906/typical_install.log

注意：当您关闭启动面板时，有些日志文件将会被删除。因此，请在关闭启动面板前收集日志文件
提示：您可以跳过启动面板，直接启动 Installation Manager 进行自动以安装。更多信息，请参考 如何直接启动 Installation Manager



收集产品安装和升级相关问题的数据:
必要的数据：

• 请说明该问题第一次发生的时间。包括您遵从的详细步骤以及您所执行的导致问题发生的命令
• 如果该问题涉及到产品升级，请您提供详细的新旧版本信息
• 如果您正使用 Installation Manger 的可视化界面，请保存并提交问题发生时您的屏幕截图
• 如果您正在以静默方式安装产品，请提供您用来启动安装程序的命令行以及您定制的响应文件
• 如果您能够启动 Installation Manager并且IBM Business Process Manager已经部分安装成功，请收集并发送下列文件和信息至IBM技术支持人员

产品安装信息及日志:

• 产品安装日志。请打包压缩install_root/logs目录并发送至IBM。
• 产品的版本信息。如果您已经安装了WebSphere Application Server及其补丁包，请运行versionInfo 命令产看版本并将结果发送至IBM。

您可以通过以下步骤，保存versionInfo 命令的输出到一个文件：
1. 打开一个终端会话或者命令行窗口
2. 导航到install_root/bin 子目录。
3. 根据您的操作系统，运行如下命令:

Windows
versionInfo.bat -maintenancePackages >versioninfo.txt

AIX, HP-UX, Linux, Solaris
./versionInfo.sh -maintenancePackages >versioninfo.txt

该命令会生成一个versioninfo.txt，请发送至IBM。

Installation Manager(IM_Data)数据目录
Installation Manager IM_Data 目录包含所有Installation Manager 相关的日志文件以及记录所有已安装产品的知识库。请打包压缩该目录并发送给IBM技术支持团队。
具体IM_Data 目录的位置请参考下表：

Platform	Installation Type	Default Data Location
Windows 2003 Windows XP	administrator	C:\Documents and Settings\All Users\ Application Data\IBM\ Installation Manager
Windows 2003 Windows XP	non-administrator	C:\Documents and Settings\ <user_name>\Application Data\ IBM\Installation Manager
Windows Vista Windows 7 Windows 2008	administrator	C:\ProgramData\IBM\ Installation Manager
Windows Vista Windows 7 Windows 2008	non-administrator	C:\Users\<user_name>\ AppData\Roaming\IBM\ Installation Manager
AIX Linux Solaris	root	/var/ibm/InstallationManager
AIX Linux Solaris	non-root	user_home/var/ibm/  InstallationManager

概要文件日志:
服务器启动日志保存在 profile_root /logs/ server_name /systemout.log 文件
概要文件升级日志文件保存在profile_root /logs/BPMProfileUpgrade.<profileName>.<timeStamp>.log目录
因此请压缩并发送 profile_root /logs至IBM。
例如：C:/IBM/BPM/v7.5/profiles/ProcCtr01/logs

数据库升级日志文件:
如果您在数据库升级过程中失败，请压缩并发送下列目录：

• 生成的数据库脚本在如下目录： profile_root/dbscripts 例如：C:\IBM\BPM\v7.5\profiles\ProcCtr01\dbscripts\
• 如果您正在升级 IBM Business Process Manager Version 7.5产品至 7.5.1，BPMGenerateUpgradeSchemaScripts 被保存在profile_root/upgrade目录：例如：C:\IBM\BPM\v7.5\profiles\ProcCtr01\upgrade
• 7.x升级脚本日志文件保存在install_root\BPM\Lombardi\tools\upgrade\upgrade_7x\logs目录
• 概要文件升级日志文件，保存在install_root\logs and profile_root/logs

启用IBM Installation Manager trace（可选）
只有在IBM要求您收集trace文件以进行进一步研究时，您才需要启用 Installation Manager Trace
1.切换到 IM_DATA/logs 目录并创建一个名为log.properties的文件
2.复制如下字符串到 log.properties 文件：
com.ibm.cic.agent.core.Engine=DEBUG
com.ibm.cic.agent.internal.core.InstallOrderManager=DEBUG
global=DEBUG
com.ibm.ws.PAKEngine=DEBUG
如果 Installation Manager正在运行，您需要重新启动Installation Manager。
3. 重复您的问题并发送您的Installation Manger的数据目录至IBM.
在收集完trace文件后，您可以通过注释以上4行字符串来禁用该功能。



其他故障排除提示和技巧:

• 检查故障发生时所生成的日志文件和dumps 文件
• 收集必要的信息并寻求IBM Business Process Manager 支持团队的帮助

向IBM技术支持团队提交数据
请参考该文档Exchanging information with IBM Technical Support 向IBM技术支持团队提交数据