IBM® Support Assistant Lite



目录

简介
逐步指南
工具安装
    安装工具
工具的使用
    设置 JAVA_HOME 环境变量
    以 Swing GUI 方式启动该工具
    以命令行控制台方式启动该工具
    在执行期间创建文件的位置
    以 Swing GUI 方式与该工具交互
    验证收集 zip 文件名
    以命令行控制台方式与该工具交互
    确定版本信息
    针对 HTTPS 上载的代理支持
商标

简介

IBM® Support Assistant Lite 工具旨在帮助对 IBM 软件产品问题进行故障诊断。该工具的主要用途是自动收集问题数据。 它还针对 IBM 软件产品遇到的各类问题提供症状分析支持。 通过收集并分析与某种类型的问题有关的信息,有助于通过调查研究来找出问题的起源。 该工具通过设置正确的跟踪级别来缩短重现某个问题所花的时间,并且减少向 IBM 支持人员发送适当的日志信息所需的工作,为客户提供帮助。在本帮助指南中,我们将介绍如何启动并运行 IBM Support Assistant Lite 工具。


逐步指南

在大多数情况下,执行以下一系列步骤将启动并运行该工具。如果您遇到了问题或者想了解有关任何这些步骤的更多信息,那么可以参阅本节后面的章节。

  1. 通过从下载的归档文件中解压缩文件来安装该工具。
  2. 以 GUI 方式或者命令行控制台方式运行该工具。

工具安装

安装工具

在所有情况下,只需从您下载的归档文件中解压缩文件,就可以安装 IBM Support Assistant Lite 工具。 可以将这些文件解压缩到您在将运行此工具的系统上选择的任何文件系统位置。这将在该目标目录中创建子目录 \ISALite。


工具的使用

设置 JAVA_HOME 环境变量

无论您以 GUI 方式还是以命令行控制台方式使用 IBM Support Assistant Lite 工具,都需要按照相同的过程来启动该工具:从命令行调用相应的启动脚本。 在 Windows 系统中,这些启动脚本是批处理文件。 而在其他环境中,这些启动脚本是 shell 脚本。

由于此工具作为 Java 应用程序实现,因此,必须先设置 JAVA_HOME 环境变量才能启动此工具。 如果 PATH 中未提供 Java,那么必须手动设置 JAVA_HOME 环境变量。 IBM Support Assistant Lite 工具需要 JRE 1.4.2 或更高版本(在 64 位 Windows 7 上需要 1.5 或更高版本),因此您必须首先确保在将要运行此工具的系统上安装了适合的 JRE。 如果已满足此条件,那么您将需要发出一个特定于操作系统的命令将 JAVA_HOME 变量设置为指向此 JRE。 Microsoft JVM/JDK 和 gij (GNU libgcj) 不受支持。 例如,在 Windows 平台上,如果在 c:\jre1.4.2 目录中安装了 jdk1.4.2,那么应使用以下命令来设置 JAVA_HOME:

SET JAVA_HOME=c:\jre1.4.2

在 Linux、AIX、HP-UX 或 Solaris 平台上,用于设置 JAVA_HOME 变量的确切命令语法取决于您使用的 shell。 例如,如果您使用的是 bash shell,并且将 JDK 安装在 /opt/jre142 目录中,那么应使用以下命令来设置 JAVA_HOME:

export JAVA_HOME=/opt/jre142

在将此工具安装到某个缺省位置后,您可能会发现它无法启动,并且报告错误消息“错误:该工具需要 JRE 1.4.2 或更高版本才能运行”。该消息表明 JRE 的版本低于 1.4.2。 在此情况下,您应当手工设置 JAVA_HOME 变量,以使之指向正确的 JRE 级别。

以 GUI 方式启动该工具

您需要发出以下启动脚本:

以命令行控制台方式启动该工具

如果 GUI 不可用,那么此工具将以命令行方式自动启动。如果希望即使在 GUI 可用的情况下仍使用控制台方式,请在命令行中指定“-console”。 在某些情况下,可能无法确定 GUI 不可用,那么此工具将不会启动。在这些情况下,需要使用“-console”重新启动此工具。

在执行期间创建文件的位置

缺省情况下,将使用 ISA Lite 安装目录来存储执行期间创建的文件。 在某些系统上,ISA Lite 安装目录是只读的。在这种情况下,请使用 -useHome 参数。该参数会将临时文件写入系统临时目录,而将持久文件写入用户主目录。

以 GUI 方式与该工具交互

以 GUI 方式启动 IBM Support Assistant Lite 工具后,将显示如下所示的图形界面。

在使用此工具执行数据收集和分析之前,必须首先如下所示在“问题类型”窗口中选择问题类型。

 

 

您必须在主 GUI 中提供的唯一输入字段值是数据收集 zip 文件的文件名,而非“问题类型”。 目前,文件名可以是您期望的任何值:例如,可以使用文件名 Install_failed_2007_01_03。如果未提供扩展名,那么该工具会自动附加“zip”扩展名。但是,如果您对于正在执行的收集操作所针对的问题开具了 PMR,并且允许此工具自动将收集结果以 FTP 方式传送给 IBM 支持人员,那么在 FTP 步骤中,此工具将强制实施 IBM 支持人员要求的特定文件命名约定:文件名必须以三个特定字段开始:<pmrnumber>.<branchnumber>.<countrycode>.<short description>.zip。该类型的文件名类似于 34143.055.000.logs.zip。为与以前的格式实现兼容,还接受使用逗号代替前三个句点(但不代替位于“zip”扩展名前的第四个句点)。 但是,句点是首选定界符。

将这些值填入后,下一步是按“收集数据”按钮。 随着收集过程的进行,收集脚本将要求您提供它完成收集活动所需的更多信息。 某个脚本可能还会要求您提供配置信息、有关导致您正在处理的问题的事件序列的信息,或者提供与其如何完成收集有关的首选项。一旦它获得了它需要的所有信息,脚本就会继续完成收集活动的其余任务。

该工具完成数据收集后,您可以将结果发送给 IBM 支持人员。 您可以选择使用 FTP(不加密),也可以选择 HTTPS(加密)进行文件传输。 该工具发送给 IBM 支持人员的 zip 文件的文件名是在“输出文件名/路径”框中输入的文件名,并且附加了服务器主机名和当前的时间戳记。

例如:如果在“输出文件名/路径”中使用的是 34143.055.000.logs.zip那么发送给 IBM 的 zip 文件的名称将为

34143.055.000.logs.zip-<hostname>-<currentTimestamp>.zip.

验证收集 zip 文件名

IBM 支持 FTP 站点 ftp.emea.ibm.com 中的自动化完全取决于在 IBM Support Assistant Lite 工具的主 GUI 中描述的文件命名约定。 如果该站点所收到文件的名称未遵循该约定,那么 IBM 支持人员就无法看到该文件。 因此,在此工具调用 FTP 操作以将收集 zip 文件发送给 ftp.emea.ibm.com 之前,此工具会依照约定来验证该收集 zip 文件的文件名。 如果文件名格式不正确,那么将会弹出一个窗口,以供您更改此文件名。 FTP 站点的当前文件命名约定如上所述,即使用句点分隔组合文件名中的各个字段。 但是,以前该约定使用逗号作为分隔符。 由于 FTP 站点中仍然处理根据先前的约定命名的文件,因此 IBM® Support Assistant Lite 工具的验证逻辑接受句点和逗号这两种定界符。

以命令行控制台方式与该工具交互

当 IBM Support Assistant Lite 以命令行控制台方式运行时,就不存在供用户输入的选择列表或输入字段。 可用的选项是以编号列表形式提供的,在输入您所作选择的编号之后按 Enter 键。 输入字段将转换为提示,此时您需要在输入字段中输入回答并按 Enter 键。

要停止收集器工具,请以控制台方式输入 quit。

该工具会提示输入文件名。在 Unix 平台上,不支持将“~”指定为用户的主目录。如果使用了“~”,那么将引用当前工作目录下由“~”表示的子目录。

控制台方式还提供静默收集功能,该功能允许您将控制台方式下所进行会话的响应记录在文件中,以后可将此文件用于驱动同一收集脚本的后续执行。

要对其进行归档,首先需要创建一个“响应文件”,其中包含针对数据收集器某次运行的问题的答案。 下次需要执行相同的数据收集时,只需在启动此工具时提供该响应文件,先前提供的答案将用于回答所有问题。 也可以对响应文件进行调整和修改,改变答案以执行不同的数据收集。

要创建响应文件,只需使用 -record 选项(后跟响应文件的文件名),以命令行控制台方式来调用此工具,例如,在 Linux 环境中,应当运行:

./runISALite.sh -console -record response.txt

以此方式运行时,会转至普通的交互式会话,您可以在此为脚本提示提供响应。 除影响当前收集外,响应还会保存到您指定的文件中。 交互式会话一旦完成,您便可以在今后使用该响应文件来执行相同的脚本,而无需显式的用户输入。

例如,要在 UNIX 环境中,使用您记录的响应文件以静默方式运行此工具,请运行:

./runISALite.sh -console response.txt

响应文件是纯文本文件,因此可以对其进行编辑,以根据需要更改用户的响应。 例如,如果希望在记录该响应文件时所在的系统以外的另一个系统上运行此工具,那么可能需要调整该响应文件中的部分值。

当使用响应文件时,请记住这些文件中可能存储了敏感信息(诸如用户名和密码),因此需要对这些文件采用某种方式进行管理,以防止对敏感信息未经授权的访问。此外,并非所有数据收集都适合静默收集选项。 某些数据收集始终需要与用户进行某种交互。 例如,可能会要求您在数据收集期间重现问题,以便收集相应的日志和跟踪文件。 在此情况下,静默收集将无法记录和重现该步骤。

向响应文件添加暂停

从 ISA Lite V1.3.4 开始,响应文件的格式变得更易于用户阅读/编辑。该文件看起来与 Java 属性文件非常相似,具有以“#”开始的注释和一系列键值对。

目前有一种向这些新的响应文件添加暂停的方法(使用您的首选编辑器)。以下是两个受支持的新键的简要描述:


确定版本信息

缺省情况下,该工具的版本(及其各种子组件)会在启动它的控制台上显示。当以 GUI 方式运行时,还可以使用“帮助 -> 关于”菜单选项找到版本信息。 如果 Java 不可用,或 Java 应用程序无法启动,那么还可以通过使用“-version”选项运行启动脚本来获取此工具的版本。

当使用“-version”选项时,启动脚本会显示版本信息,但不会实际调用此工具。

针对 HTTPS 上载的代理支持

缺省情况下,当使用 JRE 1.5 或更高版本时,上载将使用系统定义的代理。在 Windows 上,JRE 使用 Internet Explorer 的代理配置。在 Unix 上,JRE 使用 GNOME 2 的代理配置。要覆盖该配置,请使用“-promptForProxy”选项输入其他代理。

商标 

IBM、IBM 徽标和 AIX 是 International Business Machines Corportation 在美国和/或其他国家或地区的商标或注册商标:

Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和/或其他国家或地区的商标。

Microsoft、Windows、Windows NT 和 Windows 徽标是 Microsoft Corporation 在美国和/或其他国家或地区的商标。

UNIX 是 The Open Group 在美国和/或其他国家或地区的注册商标。

Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。

HP-UX 是 Hewlett-Packard Company 的注册商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。