安装 IBM Support Assistant V3

目录:

1. 简介
2. 系统需求
3. 安装 IBM Support Assistant V3
4. 运行 IBM Support Assistant V3
5. 卸载 IBM Support Assistant V3
6. 维护和故障诊断

1. 简介

本文档包含一些有用的信息,在安装 IBM Support Assistant V3.0.0 期间,这些信息对您很有帮助。在 Microsoft Windows、Unix 和 Linux 系统上,IBM Support Assistant 都使用 InstallShield 安装程序来进行安装。并且,还提供了有关在安装期间和安装完成后如何修改应用程序参数的指示信息以及卸载 IBM Support Assistant 的方法。

2. 系统需求

IBM Support Assistant V3.0 支持下列操作系统: 在 Windows 系统上,IBM Support Assistant 使用 Eclipse 嵌入式浏览器窗口小部件。嵌入式窗口小部件需要 MS Internet Explorer 6.x。

在 Unix 和 Linux 平台上,可以在下列 Web 浏览器中使用 IBM Support Assistant 应用程序:

3. 安装 IBM Support Assistant

在所有平台上,都可以采用三种方式来安装 IBM Support Assistant:

GUI 安装方式:

这是缺省安装方式,只需对操作系统执行可执行的安装程序文件就可以开始安装。它将在一个图形向导中启动 IBM Support Assistant 安装程序,该图形向导将指导用户完成整个安装过程。

控制台安装方式:

此安装方式将在一个基于文本的向导中启动 IBM Support Assistant 安装程序,该向导将指导用户完成整个安装过程。当无法进行 GUI 安装,但是用户又想在一个仅限于文本的环境中使用安装向导时,这种安装方式就很有用。
可以通过使用以下命令来启动控制台安装:

静默安装方式:

这种安装方式不需要任何用户参与。它允许用户在一个文本文件中指定向导设置,而不需要采用图形方式或控制台方式运行该向导。对于静默方式执行,在运行安装程序时应使用下列命令行实参:
其中
选项文件:
选项文件指定可以在安装执行期间设置的值。当向导在使用“-options”命令行选项的情况下运行时,就可以使用选项文件来为安装配置下面所指定的选项。阅读每个设置的文档,以便了解如何更改该设置的值。必须在一个文本文件中指定这些设置,然后就可以将该文件用作选项文件。IBM Support Assistant V3 下载归档附带提供了样本选项文件。
用于 IBM Support Assistant 静默安装的选项文件中必须包含下列设置:

1. 许可证接受协议:选项文件必须包含有关是否接受 IBM Support Assistant 许可证协议文件中所述“许可证条款和条件”的声明。这是通过向选项文件中添加下列行来指定的:
其中
2. 安装位置:选项文件必须包含静默安装程序安装 IBM Support Assistant 的位置。这是通过向选项文件中添加下面这一行来指定的:
其中


3. 安装类型(可选):

其中

重要说明:
如果在同一系统上已安装了 IBM Support Assistant V2,则安装程序不允许将 IBM Support Assistant V3 安装到同一位置。在 GUI 和控制台安装程序中,并且将会通过提示您更改安装位置来停止安装过程,以避免冲突。在静默安装方式下,安装过程将退出,错误代码值为 2004

4. 在已安装该应用程序的情况下继续进行安装:如果检测出在机器上已安装了 IBM Support Assistant V3,静默安装操作就会停止并退出,并且错误代码值为 2003。这样做的原因是,IBM Support Assistant V3 设计成每台 Windows 机器只能使用一个安装实例,对于其他平台来说,每个用户只能使用一个实例。但是,如果您希望修改现有的安装以继续安装任何其他功能部件,则必须在选项文件中明确地指定以下内容:

在 Unix 或 Linux 系统上:在下载安装程序之后,应确保它具有正确的许可权以便执行它。可以通过运行以下命令:

以将执行许可权授予安装程序。

4. 运行 IBM Support Assistant

IBM Support Assistant 是一个 J2EE Web 应用程序。在 Windows 上,IBM Support Assistant 提供了它自己的使用 Eclipse 嵌入式浏览器窗口小部件的 GUI。在所有其他平台上,用户使用 Web 浏览器来与 IBM Support Assistant 进行交互。

Windows 平台:

从“开始”菜单(开始 -> 程序 -> IBM Support Assistant -> IBM Support Assistant V3)或者从 IBM Support Assistant V3 的桌面快捷方式启动 IBM Support Assistant。要停止该应用程序,请单击左上角的 ISA 图标,然后依次单击“关闭”和“确定”。

所有其他平台:

通过从命令提示符运行 startisa.sh 脚本来启动 IBM Support Assistant。调用此脚本后,该命令将显示一些消息,接着启动 Mozilla 浏览器并打开 IBM Support Assistant V3 欢迎页面。如果系统尚未安装 Mozilla 浏览器(mozilla 二进制文件), 那么将需要手工打开受支持的浏览器并且必须在地址字段中输入 IBM Support Assistant URL。可以在 <install_root>/workspace/logs/isaurl.log 文件中找到 IBM Support Assistant URL。

要停止 IBM Support Assistant,可从命令提示符处执行 stopisa.sh 脚本。控制台应返回下面这样一条消息:

注意:停止该应用程序的用户必须有权杀死 IBM Support Assistant V3 进程(即,他是启动该应用程序的用户,或者是超级用户)。

在执行启动/停止脚本时写入到控制台中的消息还会分别写入 startisa.log 和 stopisa.log 文件,这两个文件都位于 IBM Support Assistant 安装文件夹中。

5. 卸载 IBM Support Assistant

Windows 平台:

可以通过三种方法来卸载 IBM Support Assistant:

1.添加/删除程序:可以通过“控制面板”中提供的“添加/删除程序”任务来卸载 IBM Support Assistant V3 条目。

2.安装位置:可以通过从安装位置执行卸载程序来调用 IBM Support Assistant 卸载程序。为此,浏览至 IBM Support Assistant 安装位置中的 _uninst 文件夹,然后运行 uninstaller.exe

3.“开始”菜单:可以通过单击 Windows“开始”菜单中的卸载 IBM Support Assistant 条目(开始 -> 程序 -> IBM Support Assistant)来卸载 IBM Support Assistant。
缺省卸载方式是通过 GUI 卸载。要采用控制台方式或静默方式进行卸载,执行下列命令以使用在上面第二种方法中所述的卸载程序:
控制台方式:

静默方式: 注意:IBM Support Assistant V3 下载归档附带提供了卸载选项文件样本。如果您选择不指定 -options 属性,并且不指定卸载选项文件,则将执行完全卸载。

所有其他平台:

可以通过运行 IBM Support Assistant 安装位置中 _uninst 文件夹中的卸载可执行文件来卸载 IBM Support Assistant。缺省卸载方式是通过 GUI 卸载。要采用控制台方式或静默方式进行卸载,执行下列命令以使用在上面第二种方法中所述的卸载程序:
控制台方式:

静默方式: 注意:IBM Support Assistant V3 下载归档附带提供了卸载选项文件样本。如果您选择不指定 -options 属性,并且不指定卸载选项文件,则将执行完全卸载。

6. 维护和故障诊断

安装/卸载日志:

安装和卸载日志文件 log.txt 位于 IBM Support Assistant 的安装位置处。如果在创建此目标文件夹之前安装就失败了,则可以检查位于您平台的 temp 位置的日志文件,也可以为该日志指定另一个位置。这可以通过在安装程序可执行文件后面添加 -is:log <log_file> 来实现,例如:

临时安装空间:

如果系统上的缺省临时位置没有足够的空间,则可以使用以下安装命令指定要明确使用的临时位置:

在某些操作系统上,如果执行安装期间系统上的空间不足就可能导致抛出“信号 11”错误。

修改端口号:

用来运行 IBM Support Assistant 的端口号是在 IBM Support Assistant 每次启动时随机选择的。但是,安装之后可以更改端口号。要完成此任务,请转到 <install_root>/configuration 文件夹,并修改 config.ini 文件中的 com.ibm.osg.webcontainer.port 条目以表示要让 IBM Support Assistant V3 使用的端口号。缺省值 0 表示在启动时将选择随机端口号。将需要重新启动 IBM Support Assistant 才能使此更改生效。

无法启动 IBM Support Assistant:

如果无法启动 IBM Support Assistant,则可以查看一些日志文件以确定问题。

防火墙访问:

如果 IBM Support Assistant 无法启动或者启动后显示空白页面,则验证没有防火墙在以上修改端口号维护设置中所提及 config.ini 文件中指定的端口上阻塞了对 IBM Support Assistant 的访问。

Unix 和 Linux 平台上的用户权限:

如果出现一条消息指出您没有启动或停止 IBM Support Assistant 的权限,请确保是 root 用户在尝试执行此操作,或者是负责安装 IBM Support Assistant 的同一个用户在执行该操作。
某些操作系统可能会限制只允许 root 用户运行低于端口号 1024 的那些端口上的程序。

检测多个安装:

启动安装程序时,如果出现一条消息指出已经安装了 IBM Support Assistant V3,则请验证未在机器上的任何位置中安装 IBM Support Assistant V3。为了确保将来可以应用正确的维护和更新内容,这一点非常重要。
如果您确定系统上未安装 IBM Support Assistant V3,但是仍然出现了此错误消息,或者您想覆盖已损坏的安装,则可以使用以下安装命令来跳过此检查:

安装期间的辅助功能选项:

可以使用“-accessibility”选项启动安装程序。这将以控制台方式启动安装程序,但是,对控制台方式进行了一些修改,使得在使用屏幕朗读器阅读安装屏幕时更容易了解这些屏幕。

Windows 平台上的退出通知:

当用户退出 ISA 主窗口时,将会提示他们确认退出。这是因为还将关闭从 ISA 中启动的所有窗口和工具。用户可以通过选择复选框来避免退出 ISA 时显示此确认消息。如果已执行此操作,但现在想重新启用此确认对话框,请执行下列步骤:

  1. 如果 ISA 正在运行,则将其关闭。
  2. 打开用来启动 IBM Support Assistant V3 的“IBM Support Assistant V3”快捷方式的属性窗口。在“快捷方式”选项卡上的“目标”字段中,在命令字符串末尾添加一个空格,然后输入字符串 -promptonexit
  3. 选择“确定”按钮。
  4. 使用该快捷方式来启动 ISA。
注意:如果您希望退出 ISA 时不再显示确认对话框,则必须从此字段中除去该字符串。

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

IBM 是 International Business Machines Corporation 在美国和/或其他国家或地区的商标。

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

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

(c) Copyright IBM Corp. and others 2004, 2006