使用资源适配器归档 (RAR) 更新向导可将独立 RAR 文件更新为更新版本。应用程序服务器使用组成资源适配器归档的类和其他代码来支持您配置的资源适配器。
开始之前
资源适配器必须安装在应用程序服务器上,并且,您必须使用与旧版本资源适配器相兼容的新版本。您可以使用组装工具来创建 RAR 文件,另外,新版本也可以由资源适配器的供应商提供。如果新版本的 RAR 文件与旧版本的资源适配器不兼容,那么无法进行更新。
Java™
连接器体系结构 (JCA) V1.6 规范添加了对于 RAR 模块中 Java 注释的支持。有关注释支持和元数据的更多信息,请参阅“对于 RAR 模块中的注释的 JCA 1.6 支持”主题。
关于此任务
当您确定需要将某个资源适配器或一组资源适配器更新为另一个版本时,请更新 RAR 文件。资源适配器的不同版本可以包括不同的设置,因此,如果您需要使用特定的一组配置选项,那么最好更新适配器。
可选择针对某个单元中的所有节点或某个集群中的所有节点更新该资源适配器。如果某些节点的版本低于 7.0,那么 RAR 更新将不受支持,直到将这些节点迁移到版本 7.0 为止。对
JCA 1.6 适配器的更新仅适用于 V9.0 节点。
如果您希望让多个版本的资源适配器在给定
Java 虚拟机 (JVM) 中生效,更新向导未提供创建另一版本并保存旧版本的选项。在此情况下,您需要创建隔离资源适配器并进行相应配置。有关更多信息,请参阅“配置资源适配器”主题。
过程
- 保存所有配置更改。
- 使用 backupConfig 工具来备份配置设置。 backupConfig 工具在 app_server_root/bin 目录中。有关如何使用此命令的更多信息,请参阅“backupConfig 命令”主题。
- 同步要更新的所有节点。
- 如果 Node Agent 与您正在更新的资源适配器相关联,请确保其处于运行状态。
- 停止所有包含已更新 RAR 文件的服务器。
必须停止与 RAR 文件相关联的节点或集群中的所有服务器。有关如何停止或启动应用程序服务器的信息,请参阅“管理应用程序及其环境”主题。
- 单击。
- 选中要更新的 RAR 文件旁边的复选框,然后单击更新 RAR。
- 指定 RAR 文件的安装路径,然后单击下一步。
- 如果 RAR 文件与浏览器在同一工作站上,请选择本地文件系统,然后进行浏览以查找该文件。
- 如果 RAR 文件在应用程序服务器所安装在的服务器工作站上,请选择远程文件系统,然后指定该文件的标准路径。
- 查看为该 RAR 文件提供的配置信息。 将显示 RAR 文件的以下信息:
- 名称
- 当前 RAR 版本
- 新 RAR 版本
- 范围
- 该资源适配器的任何现有副本。带有星号 (*) 的资源适配器是该资源适配器的副本,您必须同时更新这些副本。
完成时单击下一步。
- 可选: 对新版本的资源适配器添加的任何属性进行编辑。另外,也可以在更新完成后编辑这些属性。
- 从列表中选择资源,以便对新属性进行编辑。 此列表只包含具有新属性的资源。
- 编辑资源属性。 使用提供的表来设置所选资源的新属性的值。
- 选中对所有资源设置复选框可将属性值应用于所有同一类型的资源。
- 单击重置为缺省值按钮可将所有属性重置为 RAR 文件中定义的缺省值。此属性重置仅影响所选资源。
- 单击下一步。
- 查看摘要面板,如果对配置设置感到满意,请单击完成。 您单击“完成”时,将自动保存所有配置更改。要恢复为旧版本的资源适配器,必须再次执行更新过程,并指定旧版本的 RAR 文件。
- 重新启动包含已更新的 RAR 文件的服务器。
下一步做什么
如果您对结果不满意,并且已使用 backupConfig 工具备份了配置,请使用 restoreConfig 工具来复原备份配置。有关如何使用此命令的更多信息,请参阅“restoreConfig 命令”主题。