自述文件：IBM Integrated Runtime V1.1.0 修订包 1

本修订包适用于 IBM Integrated Runtime (IR) V1.1.0 产品。 修订包是为基本产品刷新包或者上个修订包安装提供 APAR 修订的机制。如果修订包的版本号高于当前系统内产品的版本，那么您可以选择应用修订包。

本修订包解决了以下问题：
APAR问题解决方案
PQ85776将项目 IRU_IHS5100S400 导入 Eclipse 开发环境的尝试失败。当从 Integrated Runtime Solution Developer 环境中导出 IRU_IHS5100S400 项目，然后将导出的项目重新导入基于 Eclipse 的开发环境时，会出现该问题。 Eclipse 的导出和导入功能使用的项目文件已经修正。
PQ85833Windows 和 Linux 中的 Sample Solution 应用程序不捕获标准错误。 Sample Solution 不捕获标准错误是由于它只将标准输出重定向到日志文件。 重定向已设置为捕获标准输出和标准错误。
PQ86072如果在同一解决方案部署点（Solution Deployer）会话中打开先前版本的解决方案，解决方案部署点（Solution Deployer）不会自动更新已修改的解决方案。在关闭并重新打开解决方案部署点（Solution Deployer）之后，解决方案的修改才可见。 Integrated Runtime 解决方案参数在 Java ResourceBundle 高速缓存中维护。现在，一旦同一解决方案部署点（Solution Deployer）会话中有再次装入 Integrated Runtime 解决方案的尝试，解决方案部署点（Solution Deployer）将立即清空 ResourceBundle 高速缓存。该操作将确保正确导入对已修改的解决方案文件的更改。

要为 IBM Integrated Runtime 产品安装本修订包，首先运行下表中相应的命令：
平台命令
Linux321.1.0-IBM-IntegratedRuntime-Linux32-FP0001
Windows1.1.0-IBM-IntegratedRuntime-Windows-FP0001.exe

有关基本 Integrated Runtime 产品的完整安装指示信息，请参阅文件 <install path>\Runtime\info\infocenter\eclipse\plugins\com.ibm.iru.doc\doc。

有关许可证的信息，请参阅<install path>/Runtime/license/<language>.txt（<Language>是文本文件的语言）。

本自述文件包含下列部分：
前提条件
安装修订包之前对文件进行备份
安装修订包
运行回滚安装
对安装进行故障诊断
消息


前提条件


安装修订包之前对文件进行备份

在安装修订包期间，会自动备份 IBM Integrated Runtime 工作空间目录中将被替换的文件。 如果备份失败，则会在继续安装之前提示您自行备份文件。

除备份 IBM Integrated Runtime 工作空间目录中的用户数据文件之外，安装过程还在工作空间中保留一个备份副本。这确保您可以访问修订包更改的任何用户数据文件。 这些工作空间文件被重命名为 <original filename>.<original extension>_<version>_<instance>。 例如，如果您在 Integrated Runtime 1.1.0.0 有一个文件名为 a.xml，当应用修订包时它被重命名为 a.xml_1.1.0.0_1。注：<instance> 中，增加文件名使您可以为同一个文件保存多个副本。

如果您在修订包备份用户数据文件之后修改了用户数据文件，然后又打算将修订包回滚到您安装过的 Integrated Runtime 的先前版本，您肯定不希望丢失对用户文件所做的修改。为避免丢失对用户数据的修改，回滚过程在执行回滚之前会检测这些已修改的工作空间文件。对于交互方式安装，将提示您选择希望备份的文件。对于静默方式的安装，将备份所有文件。这些备份文件位于 <install path>/Runtime 目录并且命名为 UserdataBackup<version>_<instance>.zip（<version> 是回滚要恢复的修订包的完整版本，<instance> 是文件的实例）。


安装修订包

您可以以交互方式或静默方式安装修订包；本节描述这两种方法。


以交互方式安装修订包

要以交互方式安装修订包，遵循下列步骤：

  1. 启动下列相应的可执行命令：
    平台命令
    Linux321.1.0-IBM-IntegratedRuntime-Linux32-FP0001
    Windows1.1.0-IBM-IntegratedRuntime-Windows-FP0001.exe

  2. 出现语言选择面板。选择语言并单击 OK 以继续。
  3. 出现欢迎屏幕。该面板显示要安装的产品的名称：Integrated Runtime 产品。
  4. 出现软件许可证协议面板。该面板显示 Integrated Runtime 许可证协议。阅读许可证协议中的条件然后选择接受或不接受许可证协议中的条件。单击下一步以继续。
  5. 出现摘要面板。 该面板显示修订包将安装到的目录并且给出修订包占用的磁盘空间量。 单击下一步以继续。

    在修订包安装过程中，将给出被修改的用户数据文件列表。用户数据文件由存储在以下目录之一的 XML、JAVA、JACL 和 BAT 文件组成：

注：

在修订包安装过程中会出现一些消息。 请参阅消息一节中对这些消息加以说明并建议用户采取何种应对措施的消息列表。如果在安装过程中遇到任何问题，请参阅安装的故障诊断这一节。


以静默方式安装修订包

要以静默方式安装修订包，请运行下列相应的可执行命令，并加上指定的选项：
平台命令
Linux321.1.0-IBM-IntegratedRuntime-Linux32-FP0001 -options IRU_setup.iss
Windows1.1.0-IBM-IntegratedRuntime-Windows-FP0001.exe -options IRU_setup.iss

运行回滚安装

修订包回滚功能部件帮助您将系统恢复到安装该修订包之前的级别。

注：任何被修订包安装修改过的文件都存储在 Backup<version>.zip 文件中（此处的 <version> 是安装了修订包的产品的全版本号）。Backup<version>.zip 文件位于 Runtime/Backup 目录中。

您可以以交互方式或静默方式运行回滚安装；两种方法在本节中都有说明。


以交互方式安装回滚

要以交互方式运行回滚安装，请从 Backup 文件夹启动下列相应的可执行文件。
平台命令
Linux32RollbackLauncher.sh
WindowsRollbackLauncher.bat

这将启动回滚向导；请按照向导的步骤完成回滚。


以静默方式运行回滚安装

要以静默方式运行回滚安装，必须在 Backup 文件夹中运行下列相应命令，使用哪个命令取决于操作系统环境：
平台命令
Linux32RollbackLauncher.sh -silent
WindowsRollbackLauncher.bat -silent


安装中的故障诊断

本节中描述的情形可能会在修订包安装或回滚过程中出现。

情形操作
修订包安装在备份文件时产生的错误。 遇到的错误有两种形式。
  • 在创 Backup<version>.zip 文件时出现问题，所以没有备份任何文件。

    在这种情况下将产生一个说明该情况的错误信息。如果你选择继续修订包安装，由于没有备份，所以不会创建回滚。另外，为避免任何干扰，如果存在以前安装的修订包，由于你不能回滚当前安装的修订包以检索以前的修订包，所以回滚的功能将被取消。备份文件夹将仍然保留以前的 Backup.zip 文件（如果您想检索此处的文件的话）。

  • 备份文件的子集时出现问题。

    在此情况下，将出现一条消息，显示一列未备份的文件。您可以选择手动备份文件，然后继续。如果继续，则安装正常进行。在回滚过程中，将出现一个警告消息，在进行回滚前应手工恢复未备份的文件。

修订包安装保存文件时失败。首先，检查日志文件以尝试确定导致失败的原因，并更正条件。如果不能确定问题，则再次运行修订包安装。由于已经备份了原来的文件，所以修订包安装不再备份。
回滚安装失败。首先，检查日志文件以尝试确定导致失败的原因，并更正条件。如果不能确定问题，则再次运行回滚安装或联系支持人员。
备份工作空间文件时出错。 如果您的工作空间文件在修订包安装之后被修改，并且执行了回滚，则出现一个窗格，显示已修改的文件。选择一个或更多文件进行备份。如果备份文件时出错，将出现提示并给出手工备份文件的选项。
错误消息的标题为“InstallShield Wizard Panel”的错误对话框中显示消息“未发现 java 类” 为运行修订包安装和卸载，您必须是 Windows 的管理员或 Linux 的 root 用户。 注销并作为拥有管理员或 root 用户权限的重新登录。

消息

本节列出了安装修订包的过程中可能出现的消息。

IRU00824：基本 Integrated Runtime 产品未安装在本系统中。

说明：因为没有安装基本 Integrated Runtime 产品，所以无法安装修订包。
用户的解决办法：安装 Integrated Runtime 产品并再次尝试安装修订包。

IRU00826：该修订包不适用于基本 Integrated Runtime 产品的安装版本。

说明：您已经安装的基本 Integrated Runtime 产品的版本与您正在尝试安装的修订包不一致。
用户的解决办法：为您的基本 Integrated Runtime 产品版本获取正确的修订。

IRU00829：已经安装了相同或更高级别的 Integrated Runtime 修订包。 点击“取消”退出安装。

说明：由于已安装修订包或其更高版本，所以不能安装该该修订包。
用户的解决办法：仅仅提供消息。不要求操作。

IRU00831：下列用户数据文件将被该修订包更新：{1}还将在这些文件原来的位置备份各文件，以提供快速访问。

说明：将列出任何被该修订包更新的用户数据文件。
用户的解决办法：仅仅提供消息。不要求操作。

IRU00832：当备份下列文件时产生错误：{0}。如果想继续，可以手工备份这些文件，但这不是必需的操作。

说明：当备份一组文件时出错。
用户的解决办法：手工备份文件列表。

IRU00833：当备份下列文件时产生的错误：{0}。如果想继续，可以手工备份这些文件，但这不是必需的操作。注：该错误将使您无法回滚。任何以前的回滚都被除去。

说明：备份所有文件时出错。如果您想继续安装修订包，您将不能回滚它。如果您有任何其它已安装的修订包，您也不能回滚它们。
用户的解决办法：在完成回滚前手工备份列出的文件。

IRU00834：由于在修订包安装过程中备份出错，不能回滚下列文件：{0}。如果想继续，只要您在修订包安装过程中按建议所说那样对它们进行了备份，就可以手工恢复它们。

说明：修订包安装过程中备份某些文件时出错。如果您手工备份了这些文件，那么请在继续之前恢复这些文件。
用户的解决办法：在继续之前手工恢复列出的文件。

IRU00835：回滚修订包时出错。请与支持人员联系。

说明：回滚过程中出错。
用户的解决办法：请与支持人员联系。

IRU00836：该回滚安装将产品恢复到先前级别，{0}。 点击“下一步”继续回滚，点击“取消”停止回滚。

说明：如果继续，您的系统将被恢复到先前的级别。
用户的解决办法：仅仅提供消息。不要求操作。

IRU00837：回滚结束。

说明：仅仅提供消息。
用户的解决办法：不要求操作。

IRU00838：您自修订包安装以来修改了下列数据文件。 选择您希望在 Runtime 目录的新文件{0}中备份的文件。 对于未在下列列表中选择的文件，您的更改将丢失。

说明：自安装修订包以来这些文件已被修改。 您选择的文件将在运行回滚应用之前被备份。
用户的解决办法：选择您希望备份的文件。

IRU00839：未找到文件{0}。

说明：由于未发现备份文件，回滚不能继续。
用户的解决办法：联系支持人员。

IRU00840：未发现文件{0}，因此不能重命名文件。

说明：安装修订包之前该文件未发现；所以不能在其目录中重命名该文件。
用户的解决办法：仅仅提供消息。不要求操作。

IRU00841：文件{0}被重命名成{2}，并且位于目录{1}中。

说明：该文件已被正确重命名。
用户的解决办法：仅仅提供消息。不要求操作。

IRU00842：文件{0}不能被重命名。文件已打开或不可靠，或目录是只读的。

说明：因为文件处于打开状态、已损坏或位于只读目录中，所以不能重命名该文件。
用户的解决办法：在 Backup 文件夹中的压缩文件中找到该文件。

IRU00843：不能检索到文件{0}所要求的消息。您可以继续安装；但是，您可能不能回滚该修订包或该系统上以前安装的所有修订包。

说明：定位一个检索来自 Rollback.properties 文件的信息出错。该问题可能是由于该文件不存在或该文件已损坏。该文件用来执行一任何原来修订包的成功的备份。
用户的解决办法：想继续安装修订包，将冒不能回滚修订的风险。

RU08843：不能检索到文件{0}所要求的消息;所以，您不能回滚修订包。联系支持人员。

说明：检索来自 Rollback.properties 文件的消息时出现问题。该问题可能是由于该文件不存在或该文件已损坏。该文件用来执行回滚。
用户的解决办法：联系支持人员。
(C) Copyright IBM Corporation 2004
IBM 法律公告：http://www.ibm.com/legal/us/