WebSphere Application Server V5 的系统管理: 第六部分：应用程序管理

3. 操纵任务数据

使用任务名、任务列名和提供了绑定信息的 J2EE 组件就可以修改任务数据（如果对应的列标记为可变的话）。以下样本代码展示了如何为特定的任务提供绑定信息。在本例中，我们指定安全性角色的用户：设想该应用程序有一个名为 Role1 的安全性角色，并且您需要给此角色指定用户 User1 和 User2：

可以使用相同的逻辑指定所有其他类型的绑定信息，比如各种任务中 EJB 的 JNDI 名、Web 模块的虚拟主机名等等。（上面的任务信息和样本代码并不允许您收集应用程序客户机模块的绑定信息。您需要使用 WebSphere Application Server 附带的客户机（Client Configuration）配置工具来配置应用程序客户机。）

4. 保存 EAR 文件和获取安装选项

在提供了各种任务中所有必需的绑定信息之后，就应该把任务数据存回到 EAR 文件中，以便将填充的 EAR 文件安装在 WebSphere 配置内。除了存储在 EAR 文件中的绑定信息之外，还有几个直接由任务收集的其他部署选项，比如 AppDeploymentOptions、EJBDeployOptions 和 MapModulesToServers。虽然这些选项不保存在 EAR文件中，但是它们应该在把应用程序装入 WebSphere配置时进行传递。在操纵了任务数据（必要时）并保存了 EAR文件之后，就可以以哈希表的形式从AppDeploymentController中获取这些选项。而这些选项又可以在应用程序安装时直接进行传递，如下面的 安装应用程序一节和 com.ibm.websphere.management.application.AppManagement接口的 installApplication API 的 javadoc 中所述。

以下代码展示了如何把任务数据保存在 EAR文件中和获取生成的安装选项：

回页首

管理应用程序

WebSphere Application Server中的应用程序管理支持提供了许多功能，比如安装和卸载应用程序、编辑已安装应用程序的绑定信息、更新整个应用程序、导出应用程序等等。这些功能是通过 com.ibm.websphere.management.application.AppManagement接口提供的，在 WebSphere Application Server中，把该接口作为基于 JMX 的 AppManagement MBean公开，可以通过运行在服务器上的代码访问它，也可以使用独立的管理客户机程序访问它。在使用 WebSphere Application Server Network Deployment（在本系列文章的 第一部分中做过说明）时，AppManagement MBean只出现在部署管理器中，部署管理器可以简化集中式配置和管理。与配置服务类似（在本系列文章的 第五部分中做过说明），也可以不在 WebSphere Application Server 中访问 AppManagement 功能。如果是把 J2EE应用程序作为产品安装的一部分进行安装，那么这种模式（称为本地模式（LocalMode））将特别有用。

AppManagementProxy

com.ibm.websphere.management.application.AppManagementProxy提供了对应用程序管理功能的统一访问，而不管访问是来自服务器流程、管理客户机流程，还是来自不在 WebSphere ApplicationServer 中的独立 Java程序。以下代码摘录演示了如何获取各种类中的 AppManagementProxy实例：

1. 要从运行在 WebSphere Application Server 中的代码访问应用程序管理功能（例如作为自定义服务），请使用：
   AppManagement appMgmt =
     AppManagementProxy. getJMXProxyForServer(); 然后，您就可以使用 AppManagement 接口来执行像安装程序这样的操作。
2. 要通过基于 JMX 的 AppManagement MBean 从外部 WebSphere Application Server 访问应用程序管理功能，您需要首先创建一个 AdminClient 来建立到 WebSphere 服务器的连接。本系列文章的 第二部分（关于“编写您自己的管理程序”）说明了您可以如何获取 AdminClient 对象：
   AdminClient adminClient = ....

// create AppManagement proxy object
AppManagement appMgmt =
     AppManagementProxy. getJMXProxyForClient (adminClient); 图2展示了在使用 AppManagementProxy 对象与 AppManagement MBean 进行通信时的请求流。
   图2. 使用远程客户机中的 AppManagementProxy
   
   
3. 要在 WebSphere Application Server 没有运行时（本地模式）访问应用程序管理功能，您可以使用下列代码创建 AppManagementProxy：
   AppManagement appMgmt =
     AppManagementProxy. getLocalProxy ();
   • 如果运行在本地模式下，您就必须把系统特性 com.ibm.ws.management.standalone 设置为 true 。如果您想要在非缺省位置上修改配置文档，就还需要通过系统特性 was.repository.root 设置 config 目录的位置。
   • 虽然可以在也可以不在 WebSphere Application Server 运行的情况下使用实用程序管理功能，但是请 不要使用本地模式同时通过 AppManagement MBean 访问应用程序管理功能，因为使用这些模式进行的更新很可能妨碍和破坏 WebSphere Application Server 配置的完整性。

在获取了 AppManagementProxy之后，您就可以执行各种管理功能了，比如安装、卸载、编辑等等。然而，在深入研究各种应用程序管理功能的细节之前，理解配置服务中的会话概念（在本系列文章的 第五部分中做过说明）与应用程序管理功能的关系是有必要的。

会话共享

配置服务允许您创建一个会话，它是一个临时性的Staging area，可以在其中保存所有的配置修改。如果保存会话，则会把会话中的所有更新都保存到 WebSphere配置存储库中。应用程序管理逻辑支持与配置服务共享会话。因此，当配置服务做了一项更改时，就有可能在同一会话中进行所有特定于应用程序的更改。如果保存这样的会话，则会保存所有的更新，包括那些特定于应用程序的更新。AppManagement接口上的所有方法都把（ String workspaceID ）作为最后的参数。下面是一个样本API：

（出现异常的是 setApplicationInfo 和 setModuleInfoAPI，因为它们虽然采用了（ String workspaceID ）作为参数，但是却没有作为 最后的s参数。）

为此参数传递空值指示没有会话共享，因此，作为此操作的结果进行的配置更改将一直保存在配置存储库中（如果操作成功的华）。下列代码演示了与配置服务共享的会话：

1. 获取配置服务（请参考 第五部分：获取配置服务）：
   ConfigService configService = ...
2. 创建一个会话（请参考 第五部分：获取配置服务）：
   Session session = ...
3. 将会话信息传递到 AppManagement 中：
   AppManagement appMgmt = ...
   appMgmt.installApplication
         (earPath, appName, properties, session.toString());
4. 在进行了所有必要的更改之后，保存该会话：
   configService.save(session, false);

安装应用程序

通过 AppManagement 接口上的 installApplication API（如果应用程序管理逻辑运行在本地模式下，则为installApplicationLocalAPI），可以把填充有特定于 WebSphere 的绑定信息的 EAR文件装入 WebSphere 配置。

com.ibm.websphere.management.application.AppManagement接口上的 installApplication API 的 javadoc解释了可以在应用程序安装时传递的各种选项，并且还展示了代码样本。这些选项也可以在 应用程序准备阶段进行收集。

配置存储库文档结构

当保存部署应用程序的会话时，就把应用程序 EAR文件以及应用程序元数据（它包括部署描述符和特定于WebSphere的绑定以及部署描述符扩展）存储在配置存储库中。此外，在部署应用程序时还创建了 deployment.xml 文件。它包含关于各种部署描述符属性和模块到目标（服务器/群集）的信息。这些文件按照下列目录结构存储在配置存储库中：

在安装目的地解压缩 EAR 文件

在 WebSphere配置存储库创建了特定于部署的文件之后（而如果在 WebSphere Application Server Network Deployment配置的情况下，则当主存储库配置与期望在其上运行应用程序模块的每个节点同步时），就在目标节点的安装目的地位置解压缩应用程序 EAR 文件。此位置是在应用程序安装时通过选项AppConstants.APPDEPL_INSTALL_DIR指定的。只要服务应用程序客户机请求，WebSphere Application Server运行时就从安装目的地位置读取应用程序业务逻辑（例如，EJB类、servlet、JSP）。然而，只有在应用程序启动时，服务器运行时才读取应用程序元数据（例如，部署描述符、特定于WebSphere的绑定）。可以从配置存储库中读取元数据，也可以从安装目的地中读取元数据，取决于在应用程序安装时指定的 APPDEPL_USE_BINARY_CONFIG选项。此选项以 useMetadataFromBinaries 属性的形式保存在 deployment.xml 中。缺省行为是从配置存储库中读取元数据。

缺省安装目的地是 ${APP_INSTALL_ROOT}/cellName/appName.ear ，它一般为 $WAS_HOME/installedApps/cellName/appName.ear 。如果把应用程序部署在异类节点上，那么就应该把安装目的地（AppConstants.APPDEPL_INSTALL_DIR选项在安装时指定的）定义为各个节点特定于平台的值的变量。 

卸载应用程序

卸载操作从 WebSphere配置中删除应用程序，因而会从它运行其上的服务器合群集中删除它。使用 uninstallApplication API（如果应用程序运行在本地模式下，则为uninstallApplicationLocal）卸载应用程序。

要从特定服务器或群集或特定节点上的所有服务其中删除应用程序，您可以编辑应用程序信息，如下面的 编辑应用程序一节所述。

在从 WebSphere配置存储库中卸载了应用程序之后（而如果在 WebSphere Application Server Network Deployment配置的情况下，则当主存储库配置与应用程序模块部署其上的每个节点同步时），EAR文件就在删除应用程序时解压缩在目标节点的安装目的地。在从目标节点中删除解压缩的 EAR文件之前停止应用程序（如果它正在运行的话）。

编辑应用程序

在安装后可以通过编辑现有的应用程序来修改在安装时指定的大多数应用程序绑定信息和应用程序选项。某些信息（比如 EJB部署、JSP预先编译）只是在安装时才可以使用。编辑操作需要进行以下步骤：

1. 获取关于已安装的应用程序的信息

使用 AppManagement 接口上的 getApplicationInfo方法获取 AppDeploymentTask 实例列表。

2. 在必要时操纵任务数据

在前面的步骤中返回的 Vector 包含各种 AppDeploymentTask实例，它们与上面的 AppDeploymentTask表中所说明的一样。这些任务可以像 操纵任务数据一节中所说明的那样进行操纵。

3. 将更改存回到已安装的应用程序中

使用 AppManagement 接口上的 setApplicationInfo方法将所作的更改存回到配置存储库或会话中。

在把已编辑的应用程序保存在 WebSphere配置存储库中之后（而如果在 WebSphere Application Server Network Deployment配置的情况下，则当主存储库配置与应用程序模块部署其上的每个节点同步时），就可以对每个节点进行以下操作：

1. 如果应用程序正运行在目标节点上，就停止和重新启动它以使新的绑定信息和部署选项生效。
2. 如果通过编辑 MapModulesToServers 任务从目标节点中彻底删除应用程序，则作为删除应用程序的结果，EAR 文件就会解压缩在目标节点的安装目的地。相反地，如果把应用程序重新部署在目标节点的应用程序服务器上，则 EAR 文件就会解压缩在安装目的地。

重新部署（更新）配置

即使在把应用程序部署到生产系统中之后，应用程序开发人员也会在他们的开发环境中继续开发和/或修改应用程序，这是很常见的现象。为了用新版本替换已部署的J2EE 应用程序，AppManagement 接口提供了 redeployApplication API（redeployApplicationLocal用于本地模式）。此功能卸载已部署的应用程序，并且安装了一个与之名称相同的新版本应用程序。

如果 WebSphere配置存储库中的应用程序在运行时被更新，那么正在运行的应用程序会首先停下来，旧的 EAR文件会从安装目的地删除，新的 EAR文件会解压缩在安装目的地，然后应用程序会重新启动。

启动和停止应用程序

WebSphere Application Server在每个应用程序服务器中都提供了 ApplicationManager MBean，它允许您启动和停止服务器上的应用程序。请参阅本系列文章的 第二部分来学习如何访问 MBean操作。

从 WebSphere Application Server Version 5.0.1 开始，AppManagement接口还提供了 startApplication 和 stopApplication API。这些功能可以启动和停止部署在所有目标（服务器和群集）上的应用程序。

回页首

使用 AppDeployment 选项的 ConfigService

有一些与部署的应用程序有关的附加属性在使用AppDeploymentTask对象安装应用程序时或安装完成之后都没有出现。这些属性保存在 deployment.xml 文件中，每个已部署的应用程序都会在配置存储库中创建 deployment.xml 文件。请参阅 下载部分中的样本代码（ AppManagementSample1.java ），以查看您可以如何使用配置服务来操纵这些属性。这些属性包括：

• startingWeight：指定在服务器启动时启动应用程序的次序；应用程序按照它们启动权重的升序进行启动。
• classloaderMode：指定应用程序类加载器搜索类的次序；在缺省情况下为 PARENT_FIRST，它表示按照下列顺序查找类：流程、应用程序、模块。另一个选项为 PARENT_LAST。

请参阅 javadocon appdeployment类来了解每个应用程序部署定义的各种属性。

回页首

结束语

WebSphere Application Server中的应用程序管理功能在版本 5.0中得到了大大的增强。在本文以及 下载部分中提供的代码样本演示了如何程序化地管理 J2EE应用程序。查看下一部分中的 URL 以获得更多的信息。

回页首

相关信息

• WebSphere Application Server V5 信息中心
  • WebSphere Application Server Javadoc
  • JMX javadoc（来自 Tivoli 的 TMX4J JMX 实现）
• Java 管理扩展主页

回页首

下载

	关于下载方法的信息

关于作者

		Ajay Apte 是 IBM 的软件工程师顾问，他在位于得克萨斯州奥斯汀市的 WebSphere 应用程序服务器发展组织工作。从应用程序服务器4.0版本以来，他已经成为 WebSphere 系统开发队伍的领导者之一。Ajay 主要从事 J2EE 应用程序管理的研究。您可以通过 ajayapte@us.ibm.com与 Ajay 联系。

对本文的评价

太差！ (1) 需提高 (2) 一般；尚可 (3) 好文章 (4) 真棒！(5) 建议？

回页首