如果开发的应用程序带有嵌入式 WebSphere Adapter,则该适配器会随此应用程序一起部署。不需要单独安装该适配器。此处描述了安装带有嵌入式适配器的应用程序的步骤。
在开始之前
仅当开发的应用程序带有嵌入式 WebSphere Adapter 并且内部装配有资源适配器归档(RAR)模块时,才应该执行此任务。有关装配应用程序的信息,请参阅
装配应用程序。
执行此任务的目的和时间
如果应用程序需要访问“企业信息系统”(EIS)中的数据,则它可以通过使用“J2EE 连接器体系结构”连接器来完成此任务。如“J2EE 连接器体系结构”(JCA)规范中指示的那样,每个企业信息系统(EIS)都需要资源适配器和连接工厂。要部署包含嵌入式
WebSphere Adapter 的应用程序,应该安装应用程序文件,并创建 J2C 连接工厂或选择现有连接工厂以供该应用程序使用。
要安装带有嵌入式 WebSphere Adapter
的应用程序,使用管理控制台来完成下列步骤:
完成此任务需要执行的步骤
- 安装该应用程序。 例如,遵循使用控制台安装调解模块 EAR 文件中的步骤。
在“将模块映射至服务器”这一步骤中,为每个 RAR 文件指定目标服务器或集群。确保将使用
RAR 模块中定义的资源适配器的所有其他模块都映射至相同目标。此外,将 Web 服务器指定为目标,这些
Web 服务器充当对此应用程序的请求的路由器。基于通过每个 Web 服务器路由的应用程序,生成该 Web 服
务器的插件配置文件(plugin-cfg.xml)。
注: 在将 RAR 文件安装到服务器上时,WebSphere ESB 会查找连接器模块的清单(MANIFEST.MF)。它首先在 connectorModule.jar 文件中查找该 RAR 文件,然后从 _connectorModule.jar 文件装入清单。如果类路径条目在
connectorModule.jar 文件的清单中,则 RAR 会使用该类路径。为了确保所安装的连接器模块找到它需要的
类和资源,请使用控制台来检查 RAR 的类路径设置。有关类路径设置的更多信息,请参阅管理控制台的“资源适配器”设置和 WebSphere Relational Resource Adapter 设置。
- 将您所作的更改保存到主配置中。 单击。
- 为新安装的应用程序创建连接工厂。 使用管理控制台来完成下列子步骤:
- 选择新安装的应用程序
- 在导航窗格中,单击。
- 在内容窗格中,单击该应用程序的名称。
- 在页面的“相关项”部分中,单击连接器模块。
- 单击 RAR 文件的名称。
- 在页面的“其他属性”部分中,单击资源适配器。
- 在页面的“其他属性”部分中,单击 J2C 连接工厂。
- 单击现有连接工厂的名称来更新它,或者单击新建来创建新的工厂。
注: 如果使用“EIS 导入”或“EIS 导出”配置了 WebShpere Adapter,则存在可以更
新的现有连接工厂或激活规范。
- 可选: 为 XA 恢复指定认证别名或者使用组件管理的认证别名。 仅对于支持 XA 事务的资源才会显示此字段。
- 可选: 选择组件管理的认证别名。
如果没有提供想要的别名或者想要另外定义一个别名,则执行下列步骤:
- 单击应用。
- 单击“相关项”下面的 J2C 认证数据条目。
- 单击新建。
- 指定常规属性。
- 单击确定以返回至“J2C 连接工厂设置”面板。
在发生以下情况时,选择或定义别名:通过使用 empty-argument getConnection() 方法和借助资源引用中指定的应用程序或每个连接工厂认证,您的应用程序的任何组件从此连接工厂获得连接。
如果安装包含本机路径元素的适配器,则考虑以下信息:当具有多个本机路径元素且其中一个本机库(本机库 A)依赖于另一个库(本机库 B)时,必须将本机库 B 复制到系统目录中。由于大多数
UNIX 系统的局限性,无法尝试在当前目录中装入本机库。
在创建并保存连接工厂之后,可以适当地修改应用程序的各个模块中定义的资源引用和指定这些连接工厂的“Java 命名和目录接口”(JNDI)名称。
注: 对于 Java 虚拟机(JVM)的每个实例,一次只能装入一个给定的本机库。因为每个应用程序都有它自己的类装入器,所以两个带有嵌入式
RAR 文件的独立的应用程序不可以使用同一本机库。当第二个应用程序尝试装入该库时,它会接收到异常。
如果任何部署在应用程序服务器上的应用程序都使用包含本机路径元素的嵌入式
RAR 文件,则必须始终确保彻底地关闭该应用程序服务器而没有未决事务。如果该应用程序服务器没有彻底地关闭,则它会在服务器重新启动时执行恢复,并且装入任何必需的
RAR 文件和本机库。恢复完成时,请不要尝试任何与应用程序相关的工作。关闭服务器,然后重新启动它。本次重新启动时,应用程序服务器不再尝试任何进一步的恢复,并且正常的应用程序处理可以继续进行。