准备应用程序更新设置

使用此页面更新已安装在服务器上的企业应用程序、模块或文件。

要查看此管理控制台页面，请执行下列操作：
  1. 单击 应用程序 > 应用程序类型 > WebSphere 企业应用程序。
  2. 选择您要更新的已安装的应用程序或模块。
  3. 单击更新。
单击更新显示帮助您更新部署在单元中的应用程序文件的页面。 您可以更新整个应用程序、单个模块、单个文件或一部分应用程序。 如果新的文件或模块与服务器上已有的文件或模块具有相同的相对路径，那么新的文件或模块将替换现有文件或模块。 如果服务器上还不存在该新的文件或模块，那么将它添加到已部署应用程序。

要更新的应用程序

指定您在“企业应用程序”页面上选择的已安装（或已部署）的应用程序的名称。

替换整个应用程序

在应用程序更新选项下，指定用新的（已更新的）企业应用程序 .ear 文件替换已安装在服务器上的应用程序。

选择此选项后，执行下列操作：

  1. 指定该 .ear 文件是在本地文件系统上还是在远程文件系统上，并指定应用程序的完整路径名。 此路径提供已更新的 .ear 文件在安装之前所在的位置。

    如果浏览器和更新文件或模块在同一机器上，无论服务器是否在该机器上，使用本地文件系统。 本地文件系统可用于所有更新选项。

    如果应用程序文件在当前单元上下文中的任何节点上，那么使用远程文件系统。

    通过在多服务器安装中使用远程文件系统，如果 Node Agent 或 Deployment Manager 正在所选节点上运行，您可以浏览节点的整个文件系统。 只有 .ear、.jar、.sar 或 .war 文件才会在浏览期间显示。

    另外使用远程文件系统选项，以指定已在运行应用程序服务器的机器上的应用程序文件。 例如，字段值可以是 app_server_install_root/installableApps/test.ear。 如果您在安装独立的 WAR 模块，那么还要指定上下文根。

    提示: 在应用程序安装期间，通常会将应用程序文件从运行浏览器的客户端机器上载到运行管理控制台的服务器机器，在该服务器机器上部署这些文件。 在这些情况下，使用运行管理控制台的 Web 浏览器来选择要上载到服务器的模块。 然而在某些情况下，应用程序文件驻留在单元中的任何节点的文件系统上。 要让应用程序服务器安装这些文件，使用远程文件系统选项。
  2. 如果正在安装独立 Web 应用程序 (WAR) 或会话启动协议 (SIP) 模块 (SAR)，那么指定 WAR 或 SAR 文件的上下文根。

    上下文根与已定义的 Servlet 映射（包含在 WAR 文件中）共同组成用户访问该 Servlet 时需要输入的完整 URL。 例如，如果上下文根是 /gettingstarted，并且 Servlet 映射是 MySession，那么 URL 是 http://host:port/gettingstarted/MySession。

  3. 单击下一步显示更新应用程序文件的向导。 此更新向导与安装向导类似，它提供了指定或编辑应用程序绑定信息提供字段。 根据需要完成更新向导中的步骤。

当更新了完整的应用程序时，卸载旧的应用程序并安装新的应用程序。 在保存配置更改并随后进行配置更改同步时，将在要运行该应用程序的节点上展开应用程序文件。 如果当更新应用程序时它正在节点上运行，那么停止应用程序、更新应用程序文件并且启动应用程序。

替换或添加单个模块

在应用程序更新选项下，指定替换已安装的应用程序中的模块或者对该应用程序添加模块。

该模块可以是 Web 模块（.war 文件）、企业 Bean 模块（EJB .jar 文件）、SIP 模块（.sar 文件）或资源适配器模块（连接器 .rar 文件）。

选择此选项后，指定模块是在本地还是在远程文件系统上，并指定模块的完整路径名。 此路径提供已更新模块在安装之前所在的位置。 有关本地文件系统和远程文件系统的信息，请参阅先前对替换整个应用程序的描述。

要替换模块，指定相对路径（模块 URI）必须与要在已安装的应用程序中更新的模块的路径匹配。

要对已安装的应用程序添加新模块，指定的相对路径不能与已安装的应用程序中模块路径匹配。 此值指定新模块期望的路径。

如果要安装独立的 Web 模块或 SIP 模块，那么指定上下文根的值。 上下文根与定义的 Servlet 映射（来自 .war 文件）进行组合，以组成用户输入以访问该 Servlet 的完整 URL。 例如，如果上下文根是 /gettingstarted，并且 Servlet 映射是 MySession，那么 URL 是 http://host:port/gettingstarted/MySession。

接着，指定是只显示要求您提供信息的安装选项还是显示所有安装选项。

指定有关模块的必需的信息后，单击下一步显示更新应用程序文件的向导。 更新向导与安装向导类似，它提供指定或编辑模块绑定信息的字段。 根据需要完成更新向导中的步骤。

添加或更新单个模块后，在保存配置更改时，新的或更新后的模块将被存储到产品配置库中已部署的应用程序中。 当这些更改与节点一起同步时，模块被添加或更新到节点的文件系统中。 如果当添加或更新模块时应用程序正在节点上运行，那么发生下列某个情况：
  • 对于到 Web 模块的更新，停止正在运行的 Web 模块，更新 Web 模块文件然后启动 Web 模块。
  • 对于模块增补，在节点上扩展添加的模块之后，在运行应用程序的应用程序服务器上启动这个添加的模块。 不需要重新启动应用程序。
  • 如果应用程序的类装入器策略设置为 Single ，以便所有模块共享一个类装入器，那么将停止并重新启动整个应用程序以进行模块级别更改。
  • 如果与该产品一起配置的安全性提供程序不支持动态更新，那么将停止并重新启动整个应用程序以进行模块级更改。
  • 对于模块的其他更新，停止整个应用程序，更新模块文件，然后启动整个应用程序。

替换或添加单个文件

在应用程序更新选项下，指定替换已安装的应用程序中的文件或者对该应用程序添加文件。

使用此选项来更新应用程序使用的文件，该文件不是 .ear、.war、.sar 和 .rar 文件，在某些情况下也不是 .jar 文件。 可以使用此选项来添加或更新不是作为应用程序模块定义的 .jar 文件。 要更新 .ear 文件，请使用替换整个应用程序选项。 要更新定义为应用程序中的模块的 .war 文件、.sar 文件、.rar 文件或 .jar 文件，请使用替换或添加单个模块选项。

选择此选项后，指定文件是在本地还是在远程文件系统上，并指定文件的完整路径名。 此路径提供已更新文件在安装之前所在的位置。 有关本地文件系统和远程文件系统的信息，请参阅替换整个应用程序的描述。

对于相对路径（模块 URI），请指定从 .ear 文件的根目录开始的文件相对路径。 例如，如果文件位于 hello.jar 模块中的 com/company/greeting.class，请指定相对路径 hello.jar。

要替换文件，相对路径必须与已安装应用程序中要更新的文件的相对路径匹配。

要对已安装的应用程序添加新文件，指定的相对路径一定不能与已安装应用程序中的已存在文件的相对路径相匹配。 此值指定新文件期望的路径。

指定文件系统和相对路径后，请单击下一步。

添加或更新单个文件后，在保存配置更改时，新文件或已更新的文件将被存储到产品配置库中已部署的应用程序中。 当这些更改与节点一起同步时，文件被添加或更新到节点的文件系统中。 如果当添加或更新文件时应用程序正在节点上运行，那么发生下列某个情况：
  • 在应用程序元数据作用域（META-INF 目录）上添加文件时，或在任何应用程序作用域上或非 Web 模块中更新这些文件时，停止整个应用程序，添加或更新文件，然后重新启动整个应用程序。
  • 在应用程序非元数据作用域（在 META-INF 目录外但不在任何模块中）上添加文件时，在不重新启动运行应用程序的情况下在文件系统中保存更改。
  • 当文件添加到或更新到 Web 模块元数据（META-INF 或 WEB-INF 目录）时，停止运行的 Web 模块，添加或更新 Web 模块文件，然后启动此 Web 模块。
  • 对于 Web 模块中的所有其他文件，在节点的文件系统上添加或更新文件，而没有停止应用程序或任何其组件。

替换、添加或删除多个文件

在应用程序更新选项下，指定通过上载压缩文件更新已安装的应用程序的多个文件。 根据压缩文件内容的不同，使用一次此选项就可以对已安装的应用程序替换文件、添加新文件和删除文件。 压缩文件中的每个条目都被看作单个文件，而相对于压缩文件根的文件路径被视为该文件在已安装的应用程序中的相对路径。

选择此选项后，指定已压缩文件是在本地还是在远程文件系统上，并指定已压缩文件的完整路径名。 您将可能使用本地文件系统，原因是您将上载压缩文件并且远程浏览仅对 .ear、.sar、.war 或 .jar 文件起作用。 指定有效的压缩文件格式，如 .zip。 此路径提供已压缩文件在安装之前所在的位置。 此选项会将压缩文件解压缩到已安装的应用程序目录中。

如果浏览器和更新文件或模块在同一机器上，无论服务器是否在该机器上，使用本地文件系统。 本地文件系统可用于所有更新选项。

要替换文件，在已压缩文件中的文件必须有与在已安装的应用程序中要更新的文件相同的相对路径。

要将新文件添加到已安装的应用程序，在已压缩文件中的文件必须有与已安装的应用程序中的文件不同的相对路径。

已安装的应用程序中文件的相对路径由两个部分并置组成：第一部分是模块（如果文件在模块内）的相对路径，第二部分是模块根中文件的相对路径（用 / 分隔）。

要从已安装的应用程序移除文件，使用在任何归档作用域中名为 META-INF/ibm-partialapp-delete.props 的文件在已压缩文件中指定元数据。 ibm-partialapp-delete.props 文件必须是 ASCII 码文件，它列示要在该归档中删除的文件，每行一个条目。 条目可以包含字符串模式，如识别多个文件的正则表达式。 要删除的文件的文件路径必须相对于具有 META-INF/ibm-partialapp-delete.props 文件的归档路径。
要删除的文件的级别 要包括在压缩文件中的 Metadata.props 文件
应用程序 将 META-INF/ibm-partialapp-delete.props 包括到压缩文件中。 在元数据 .props 文件中，列出要删除的文件。 文件路径是相对于 META-INF/ibm-partialapp-delete.props 文件的位置。

例如，要从 my.ear 文件的根删除名为 utils/config.xmi 的文件，那么将行 utils/config.xmi 包括到 META-INF/ibm-partialapp-delete.props 文件中。
模块 将 module_uri/META-INF/ibm-partialapp-delete.props 包括到压缩文件中。

要从模块删除一个文件，在元数据 .props 文件中包括相对于该模块的文件路径。 例如，要从 my.jar 模块中删除 a/b/c.jsp ，请在压缩文件的 my.jar/META-INF/ibm-partialapp-delete.props 文件中包含 a/b/c.jsp 。

要在删除模块内的多个文件，在元数据 .props 文件中列示要删除的文件，每行列示一个条目。 例如，要从 my.war 文件中删除所有 JavaServer Pages (.jsp 文件) ，请在 my.war/META-INF/ibm-partialapp-delete.props 文件中包含行 .*jsp 。 此行使用正则表达式 .*jsp 来标识 my.war 中的所有 .jsp 文件。

您可使用单个部分应用程序文件添加、删除和更新多个文件。

指定文件系统路径后，请单击下一步。

部分应用程序更新后，当保存配置更改时，新的或已更新的应用程序文件将存储在 WebSphere® Application Server 配置库中的已部署应用程序中。 当这些更改与节点一起同步时，文件被添加或更新到节点的文件系统中。 因为部分应用程序选项更新多个文件，使用部分应用程序中的个别文件确定重新启动的应用程序组件。

部分应用程序压缩文件中的条目的示例如下所示：

util.jar
META-INF/ibm-partialapp-delete.props
foo.jar/com/mycomp/xyz.class
xyz.war/welcome.jsp
xyz.war/WEB-INF/web.xml
webmod.war/META-INF/ibm-partialapp-delete.props

对于此示例，META-INF/ibm-partialapp-delete.props 文件包含 .*.dat 和 tools/test.jar 文件。 webmod.war/META-INF/ibm-partialapp-delete.props 文件包含 com/test/.*.jsp 和 WEB-INF/test.xmi 文件。

部分应用程序更新选项执行下列操作：
  • 在已部署应用程序中添加或替换 util.jar。
  • 在已部署应用程序的 foo.jar 文件中添加或替换 com/mycomp/xyz.class 。
  • 从应用程序而不是从任何模块删除 *.dat 文件。
  • 从应用程序删除 tools/test.jar。
  • 在已部署应用程序的 xyz.war 模块中添加或替换 welcome.jsp 。
  • 替换已部署应用程序的 xyz.war 模块中的 WEB-INF/web.xml 。
  • 从 webmod.war 模块中删除 com/test/*.jsp 。
  • 从 webmod.war 模块中删除 WEB-INF/test.xmi 。

将 META-INF/ibm-partialapp-delete.props 文件中的正则表达式元字符进行转义。 例如，要删除名为 Abc 的类的内部类，请使用正则表达式 Abc\$.*，其中 $ 是使用了反斜杠 (\) 进行转义的正则表达式元字符。

META-INF/ibm-partialapp-delete.props 文件可能包含下列文本：

.*.dat

webmod.war/META-INF/ibm-partialapp-delete.props:
com/test/.*.jsp
WEB-INF/test.xmi