Zip存档收集器创建临时目录完整内容的zip存档分析报告

　　Zip存档收集器创建临时目录完整内容的zip存档分析报告

　　压缩存档

　　采集器将创建一个 zip 存档，其中收录采集期间创建的临时目录的完整内容。在 ANT 中，每个操作负责将所需的文件放置在 ${autopdtmp} 属性指示的目录中。这相当于：

　　\.metadata\.plugins\com.ibm.esupport.autopd.core\

tmp\

　　必须采集数据

　　归档中最重要的一项是对应MustGather文档中数据镜像所需的信息。该数据可以在 WC_MustGather 目录中找到。该目录保存在客户端文件系统中找到的每个文件系统的原创文件路径结构。它包括 WebSphere Commerce 应用服务器日志、数据库提取、来自 EAR 的静态文件（部署在 WebSphere 应用服务器中的实例）和来自 WebSphere Commerce 安装目录的静态文件（产品文件）以及 WebSphere 应用服务器安装命令。

　　/WC_MustGather 收录以下资产：

　　有关应采集的那些文档的完整列表，请参阅“采集数据”部分中相应的 MustGather。

　　分析报告

　　采集器还会在存档的 /WC_Reports 目录中创建分析报告。该报告收录一些有关环境和馆藏本身的信息。该报告首先列出了用于集合的 ISA 版本，如图 28 所示。

　　图28.信息报告

　　

　　接下来，突出显示在 SystemOut.log 上检测到的错误，如图 29 所示。

　　图 29. 突出显示检测到的错误

　　

　　每个部分都提供了 Google® 搜索的链接。这些链接的内容与 IBM 记录的错误消息相关的一些关键术语或任何已知问题有关。

　　单击主报告中的 ActionXML Collector Summary 链接将显示一个解释要做什么的文档（图 30）。对于没有此文档的人，它会解释原因（如果不需要，由客户端拒绝许可等）。它还提供了自身的概述，包括以下信息：

　　图 3 0. 集合概览

　　

　　返回主报告，其中显示了客户端请求和收到的响应的概览，如图 31 所示。

　　图31.用户对问题的回答

　　

　　最后，将显示客户端环境的概览（图 32）。这表明客户端在哪个修订包上，是运行时环境还是开发人员工具包环境，以及客户安装了哪些 APAR。如果是Runtime服务器，数据将表示为产品级和实例级。

　　图32.环境概览

　　

　　采集器日志和属性

　　在存档中，以下目录保存自动数据采集器的输出、日志、配置和属性：

　　一般来说，使用存档解决问题时不需要检查它们，但在调试自动采集器本身的行为时它们很有用。

　　临时日志文件

　　采集器运行过程中，使用ISA工作台时，在以下目录创建临时目录：

　　\.metadata\.plugins\com.ibm.esupport.autopd.core\

tmp\

　　创建的采集档案位于以下目录：

　　\.metadata\.plugins\com.ibm.esupport.autopd.core\

collections\

　　ISA 采集器日志位于以下目录中：

　　\

　　请注意，ISA 日志收录在集合 zip 存档中，这已在上一节中提到。

　　采集器运行过程中，使用ISA Lite时，在以下目录创建临时目录：

　　\tmp\

　　对于 ISA Lite，采集器日志位于以下目录中：

　　\log

　　高级配置

　　有一些方法可以更改采集器的默认行为。一些组件利用采集器配置文件，允许以下配置：

　　ISA 工作台的配置文件位于：

　　\\applications\eclipse\plugins\

com.ibm.esupport.client.product.SSZLC270_\config\

wc-autopd-config.properties

　　对于 ISA Lite，配置文件位于：

　　\config\wc-autopd-config.properties

　　日志级别

　　记录器类，用于记录自定义 WebSphere Commerce Java 任务，可以使用 wc.logLevel.debug 属性进行配置。默认值为“false”，用​​于标准录制。设置为“true”以添加更详细的记录以供调试。

　　#logLevel, set to true to enable verbose logging wc.logLevel.debug=false

　　数据库配置

　　提取数据库数据的方法也可以使用属性文件进行配置。有多种方法可用于自动确定数据库连接信息。默认情况下，dbPropertySource 设置为“wcServerXML”值，这意味着大多数数据库配置值来自实例配置文件。将通知用户剩余价值。

　　如果dbPropertySource的值设置为“promptUser”，那么所有相关问题都会提示给用户，而不是从实例配置文件中检索。

　　最后，如果将dbPropertySource 值设置为“wc-autopd-config”，则必须从wc-autopd-config.properties 文件中检索除数据库用户密码之外的所有值。用户经常会收到数据库密码作为输入提示，因为出于安全原因，密码从未被坚持。

　　使用 wc-autopd-config 配置时，有三个选项。您需要设置清单 1 中的值。默认情况下，使用 JDBC 连接的通用类型 4 驱动程序（用于 DB2 和 Oracle®），它被配置为 DB2® 数据库。您可以更改 wc.dbDriver、wc.dbUrl 和 wc.dbDriverPath 的值以支持旧的 DB2 驱动程序（键入 2） 或 Oracle Support 通用驱动程序。

　　列出1.配置设置

　　

#method of pulling the values for DB

#options: wcServerXML, promptUser, wc-autopd-config

dbPropertySource=wcServerXML

# Universal - Type 4 (DB2)

wc.dbType=DB2

wc.dbDriver=com.ibm.db2.jcc.DB2Driver

wc.dbUrl=jdbc:db2://localhost:50000/mall

wc.dbDriver.path=C:\SQLLIB\java\db2jcc.jar

wc.dbName=mall

wc.dbUserName=db2inst1

# Universal - Type 4 (Oracle)

#Oracle

#wc.dbType=oracle

#wc.dbDriver=oracle.jdbc.driver.OracleDriver

#wc.dbUrl=jdbc:oracle:thin:@localhost:1521:O10G

#wc.dbDriver.path=C:\oracle\product\10.2.0\db_1\jdbc\lib\

classes12.jar

#wc.dbName=O10G

#wc.dbUserName=wcsuser

　　快速采集模式

　　在 ISA Workbench 或 ISA Lite 上运行时，另一种选择是使用 QuickCollect 模式。为了避免采集器每次都询问常见问题，如果答案相同，请在 wc-autopd-config.properties 上启动 QuickCollect 模式，如清单 2 所示。

　　列出2.QuickCollect 配置

　　

wc.quickCollect=true

wc.quickCollectActions=GatherFiles,GatherSQL

wc.root=D:/WebSphere/WCToolkit70

wc.instanceName=demo

was.root=D:/WebSphere/SDP/runtimes/base_v7

was.profile.path=D:/WebSphere/WCToolkit70/wasprofile

was.profile.name=wasprofile

was.cell=WC_demo_cell

was.node=WC_demo_node

was.server.name=server1

wc.ear.install.path=D:/WebSphere/WCToolkit70/workspace/WC

updi.root=D:/WebSphere/UpdateInstaller

　　将 wc.quickCollector 更改为“true”。然后将清单 2 中显示的其他属性设置到文件系统中的正确位置。

　　在 QuickCollect 模式下运行时，采集器可以减少向用户提示的次数。请注意，这不需要每个操作的许可。因此，需要预先许可，以便可以切换 wc.quickCollectActions 属性中列出的操作的设置。默认配置可以采集所有文件和数据库摘要，如 GatherFiles 和 GatherSQL 的值所示。但是，如果 wc.quickCollectActions 收录 GatherTrace，仍然会提示您复制问题并设置跟踪字符串，因为这是必需的交互。

　　全面的激活和禁用操作

　　可以完全禁用收录用户永远不想授权的操作的操作（例如，如果 DBA 始终需要从数据库中获取 SQL 数据）。无论哪个操作设置为 true，它都会运行（并假设许可）。那些在 wc-autopd-config.properties 中设置为“false”的操作将不会运行（并且不需要权限），如图 3 所示。

　　列出3.启用和禁用操作

　　

#Enabled Actions, default = true

GatherFiles=true

AskQuestion=true

wc_gatherTrace=true

GatherSQL=true

InvokeShellCommand=false

ModifyFile=false

GatherScreenShot=true

　　结论

　　在解决自己的问题时，WebSphere Commerce 自动化数据采集器旨在改进和简化数据的获取，或与 IBM 支持部门合作。采集器通过 IBM Support Assistant 或 ISA Lite 框架运行，并保留用户对其环境中发生的任何操作的控制权。自动采集器可以获得所有必要的跟踪、文件、数据摘要、屏幕截图和自定义附件，以帮助通过 IBM 支持确定问题的根本原因，镜像手动 MustGather 文档。 HTML 分析报告随每个集合生成，其中汇总了数据集合和客户端概述。