安装调解模块包括将调解模块的可安装 EAR 文件移至将托管调解模块的服务器或集群。如果已
安装调解模块启动和运行都正常,则认为它们已部署。
在开始之前
如果已将调解模块导出至 JAR 文件,则使用 serviceDeploy 命令从调解模块 JAR 文件创建可安装 EAR 文件。有关为调解模块创建可安装 EAR 文件的更多信息,请参阅
部署调解模块。
执行此任务的目的和时间
要使 WebSphere ESB
能够使用调解模块提供的功能来集成应用程序和服务,需要将该模块的 EAR 文件安装至服务器或集群,然后
启动已部署的模块。
本主题描述如何使用管理控制台来安装调解模块
EAR 文件。或者,还可以使用其他方法,如使用 install 或 installinteractive 命令以及 wsadmin 工具,
以将企业应用程序文件安装到 WebSphere Application Server
中的方式进行安装。
要点: 在开始执行下面的步骤之后,如果您又决定不安装该应用程序,则单击取消以退出安装。不要在未单击应用程序安装页面上的取消的情况下直接进入另一个管理控制台页面。
要使用管理控制台来安装调解模块 EAR 文件,请完成下列步骤:
完成此任务需要执行的步骤
- 单击控制台的导航树中的。 将出现准备应用程序安装的两个页面中的第一个页面。
- 在“准备应用程序安装”的第一个页面上,完成下列子步骤:
- 指定调解模块 EAR 文件(.ear 文件)的完整路径名。 要安装的
EAR 文件可以在客户机(运行管理控制台 Web 浏览器的机器)或服务器(与客户机相连接的机器)上。如果
指定客户机机器上的 EAR 文件,则管理控制台将该 EAR 文件上载到运行控制台的机器并继续进行应用程序
安装。
- 单击下一步。
- 在准备应用程序安装的第二个页面上,完成下列子步骤:
- 选择是否生成缺省绑定。
使用缺省绑定将导致使用缺省值来填充应用程序中任何未完成的绑定。但是不会改变现有绑定。
可以定制在生成缺省绑定时使用的缺省值。
- 单击下一步。 如果显示安全警告,单击继续。将显示安装新的应用程序页面。如果选择生成缺省绑定并且应用程序不使用资源适配器,则可以进入“摘要”步骤(下面的最后一步)。
- 在步骤:选择安装选项面板上,为下列设置提供值。 有关此页面上设置的更多信息,请参阅选择安装选项设置。 如果未指定值,则使用缺省值。
- 对于安装应用程序的目录,指定将安装应用程序 EAR 文件的目录。 缺省值为 APP_INSTALL_ROOT/cell_name,其中变量
APP_INSTALL_ROOT 为
install_root/installedApps。例如,对于安装在 Windows 上
C:\Program Files\WESB\
中的 WebSphere ESB,缺省位置是
C:\Program Files\WESB\profile_name\installedApps\cell_name。
注: 如果将应用程序安装在独立概要文件中时未指定安装目录,则该应用程序的安装目录是 APP_INSTALL_ROOT/base_cell_name。如果将独立服务器添加至部署管理器单元,则新服务器配置的单元名将成为部署管理器节点的单元名。如果
将 -includeapps 选项用于 addNode 实用程序,则在 addNode 操作之前安装的应用程序仍然使用安装目录 APP_INSTALL_ROOT/base_cell_name。但是,
将独立服务器添加至网络配置之后安装的应用程序使用缺省安装目录
APP_INSTALL_ROOT/network_cell_name。在运行 addNode 操作时,要将应用程序移至 APP_INSTALL_ROOT/network_cell_name
位置,则应该在安装期间将安装目录明确指定为 ${APP_INSTALL_ROOT}/${CELL}。这种情况下,总是可以在
APP_INSTALL_ROOT/current_cell_name 中找到应用程序文件。
- 对于分布应用程序,指定 WebSphere ESB
是否扩展或删除安装目标中的应用程序二进制文件。 缺省值是启用应用程序分布。这样,在控
制台中保存更改时,最新安装的应用程序的应用程序二进制文件将被扩展至指定的目录。当您卸载和保存对
配置的更改时,这些二进制文件也被删除。如果禁用此选项,则必须确保在希望运行应用程序的所有节点的目标目录中相应地扩展应用程序二进制文件。
要点: 如果禁用此选项,同时未将应用程序二进制复制并扩展至节点,则稍后保存配置或手工同步不会为您将这些应用程序二进制移至节点。
- 对于使用二进制配置,指定是否使用绑定、扩展和应用程序部署文档
deployment.xml 文件(缺省值)或 EAR 文件中的部署描述符。
- 对于应用程序名称,输入应用程序的名称。 应用程序名在单元中必须是唯一的,并且不能包含对象名中不允许的字符。有关对象名中不允许使用的字符列表,请参阅对象名。
- 对于创建资源的 MBean,指定应用程序启动时是否创建该应用程序中各种资源(例如,servlet 或 JSP 文件)的 MBean。 缺省值是创建 MBean 实例。
- 对于启用类重新装入,指定更新应用程序文件时是否启用类重新装入。 缺省值是不启用类重新装入。 启用类重新装入会将调解模块的
deployment.xml 文件中的 reloadEnabled 设置为 true。如果调解模块的类定义发生变化,则服务器运行时会停止然后启动应用程序来重新装入应用程序类。
- 对于重新装入时间间隔(以秒计),指定扫描应用程序的文件系统以查找已更新文件的秒数。 缺省值是 EAR 文件的 IBM 扩展(META-INF/ibm-application-ext.xmi)文件中重新装入时间间隔属性值。 要启用重新装入,请指定一个大于零的值(例如,1 到 2147483647)。要禁用重新装入,指定零(0)。
仅当启用类重新装入时,此处指定的重新装入时间间隔才会生效。
- 对于部署 Web Service,指定在应用程序安装期间 Web Service 部署工具
wsdeploy 是否运行。 该工具生成运行使用 Web Service 的应用程序所需的代码。缺省值是不运行 wsdeploy 工
具。对于以下情况,必须启用此设置:EAR 文件包含使用 Web Service 的模块,并且先前无论从组装工具的部署菜单选项还是命令行都没有对该 EAR 文件运行 wsdeploy 工具。
- 对于验证输入关闭/警告/失败,指定 WebSphere ESB
是否在应用程序安装或更新期间检查指定的应用程序引用,并且如果验证已启用,则会通知您不正确的引用或使操作失败。 应用程序通常引用使用容器管理的持久性(CMP)bean 的数据源的资源,或引用使用在部署描述符中定义的资源引用或资源环境引用的资源。验证检查应是否在该应用程序部署目标的作
用域中定义了应用程序引用的资源。 选择关闭以表示无资源验证、警告表示有关错误的资源引用的警告消息或失败以表示停止因不正确的资源引用而失败的操作。
- 对于处理嵌入式配置,指定是否应该处理嵌入式配置。 嵌入式配置由一
些文件组成,如 resource.xml 和 variables.xml。
当选中此选项或此选项为 true 时,从 .ear 文件中将嵌入式配置装入应用程序作用域。如果 .ear 文件不包含嵌入式配置,则缺省值为 false。如果 .ear 文件包含嵌入式配置,则缺省值为 true。
- 在步骤:将模块映射至服务器面板上,从集群和服务器列表中为每个模块选择一个目标服务器或集群。 选择模块旁边的复选框以选中调解模块。
如果应用程序使用 WebSphere Adapter,则对每个 RAR 文件指定目标服务器或集群。同时将使用 RAR 模块中定义的资源适配器的所有其他模块映射至相同的目标。
注: 将 RAR 文件安装到服务器上时,WebSphere ESB 会查找连接器模块的清单(MANIFEST.MF)。它首先在 connectorModule.jar 文件中查找该 RAR 文件,然后
从 _connectorModule.jar 文件装入清单。如果类路径条目在
connectorModule.jar 文件的清单中,则 RAR 将使用该类路径。为了确保已安装的连接器模块找到它需要的
类和资源,请使用控制台来检查 RAR 的类路径设置。有关类路径设置的更多信息,请参阅管理控制台的“资源适配器”设置和 WebSphere Relational Resource Adapter 设置。
可以把 Web 服务器指定将请求路由至应用程序的目标。每个 Web 服务器的插件配置文件 plugin-cfg.xml 都基于通过该 Web 服务器路由的应用程序生成。如果想要某个 Web 服务器为应用程序提供服务,则使用 Ctrl 键选择应用程序服务器或集群以及 Web 服务器,以便基于通过该 Web 服务器路由的应用程序生成该 Web 服务器的插件配置文件 plugin-cfg.xml。
- 如果应用程序定义资源引用,对于步骤:将资源引用映射至资源,为表示资源引用中指定的逻辑名的资源指定 JNDI 名称。 在“摘要”面板上单击完成之前,必须将应用程序中定义的每个资源引用绑定至
WebSphere ESB 配置中定义的资源。
- 可选: 为该资源指定登录配置名称和认证属性。
- 单击确定以保存值并返回至映射步骤。
- 如果应用程序使用 Web 模块,则对于步骤:为 Web 模块映射虚拟主机,从列表中选择应该映射至该应用程序中定义的 Web 模块的虚拟主机。
如果某个 URL 用来访问工件
(如 Web 模块中的 servlet 和 JSP 文件),则在虚拟主机定义中指定的端口号用于该 URL 中。每个
Web 模块必须映射至一台虚拟主机。未指定所有需要的虚拟主机将导致在“摘要”面板上单击完成之后出现验证错误。
- 如果应用程序在其部署描述符中定义了安全角色,则对于步骤:将安全角色映射至用户/组,
指定映射至每个安全角色的用户和组。
选择角色以选中所有角色或选中个别角色。对于每个角色,选择下列其中一个选项来确定应用安全性的方式:
选项 |
描述 |
每个人 |
这相当于没有安全性。 |
所有已认证的 |
使用有效用户名和密码进行认证的所有人都是该角色
的成员。 |
已映射用户 |
将各个用户列示为该角色的成员。 |
已映射组 |
添加组是添加用户的最方便的方法,已标识组的每个成员都会成为该角色的成员。 |
对于已映射用户或已映射组,要从用户注册表中选择特定用户或组,请完成下列子步骤:
- 选择角色,然后单击查询用户或查询组。
- 在显示的“查询用户/组”面板上,输入搜索条件以从用户注册表中抽取用户或组的列表。
- 从显示的结果选择个别用户或组。
- 单击确定以将所选用户或组映射至步骤:将安全角色映射至用户/组面板上
选择的角色。
- 如果应用程序具有其部署描述符中定义的 RunAs 角色,对于步骤:将 RunAs 角色映射至用户,指定每个 RunAs 角色的 RunAs 用户名和密码。 RunAs 角色由与另一个企业 bean 交互的同时必须作为特殊角色运行的企业 bean 所使用。选择角色以选中所有角色或选中个别角色。
在选择角色后,输入用户名和密码的值并确认密码,然后单击应用。
- 如果应用程序包含资源环境引用,则对于步骤:将资源环境引用映射至资源,指定映射至资源环境引用中所定义逻辑名的资源的 JNDI 名称。 如果每个资源环境引用都没有与它相关联的资源,则在单击完成之后,会出现验证错误。
- 如果应用程序将 Run-As 标识定义为系统标识,则对于步骤:将RunAs 系统替换为 RunAs 角色,可以选择将它更改为 RunAs 角色并为指定的 RunAs 角色指定用户名和密码。 选择系统标识暗示调用通过使用 WebSphere Application Server 安全服务器标识完成并且应该小心使用此调用,因为此标识具有较多特权。
- 如果应用程序具有映射至使 Oracle 数据库进行后端处理的资源的资源引用,则对于步骤:为 Oracle 类型提供程序指定隔离级别,指定或更正应用程序使用这种资源时用于这种资源的隔离级别。 Oracle 数据库仅支持 ReadCommitted 和 Serializable 隔离级别。
- 在“摘要”面板上,验证将安装应用程序模块的单元、节点和服务器:
- 在单元/节点/服务器旁,单击单击此处。
- 验证设置。
- 单击完成。
结果
将出现多条消息,指示应用程序文件是否成功安装。
如果接收到 OutOfMemory 异常并且源应用程序文件未安装,则您的系统可能没有足够的内存,或者您的应用程序可能包含了太多模块以致无法成功安装到服务器上。如果系统内存不足不是导致异常的原因,则再次打包应用程序,以便 .ear 文件含有较少的模块。如果系统内存不足和模块数都不是导致异常的原因,则检查在运行管理控制台的应用程序服务器的
Java 虚拟机页面上指定的选项。然后,尝试再次安装应用程序文件。
在安装期间,将在配置会话提供的目录中解压缩某些应用程序文件,当保
存了配置时,将在 WebSphere Application Server 配置库中保存这些文件。在 Windows 机器上,对文件路
径的限制为 256 个字符。因此,如果配置会话或配置库中的应用程序文件的路径超出 256 个字符的限制,则应用程序安装可能失败。您可能看到 FileNotFound 异常,在消息中显示 path name too long。
要克服这些问题,应该缩短应用程序名称和模块 URI 名称的长度,这有助于减小文件路径长度。然后,尝试再次安装应用程序文件。
下一步做什么?
在应用程序文件安装成功后,执行下列操作:
- 关联任何共享库(应用程序需要)到应用程序。
- 保存对配置的更改。这样,向管理配置注册了应用程序并且将应用程序文件复制到目标目录,该目录为
缺省情况下的
install_root/installedApps/cell_name 或您指定的目
录。安装到网络部署概要文件中时,如果部署管理器上的配置与各个节点上的配置同步,文件将复制至远程节点。
- 如果模块是在服务器集群上部署的,则单击“企业应用程序”页面上的展示更新以对集群的所有成员传播已更改配置。“展示更新”将按顺序更新包含集群成员的节点上的
配置。
要使 WebSphere ESB
能够使用调解模块提供的功能来集成应用程序和服务,必须启动已部署的模块。可以手工启动该模块或将其
配置为自动启动。还可以采用其他方式来管理模块;例如,更改模块的配置、停止或更新模块以及管理其活动。