使用此页面更新已安装在服务器上的企业应用程序、模块或文件。
指定您在“企业应用程序”页面上选择的已安装(或已部署)的应用程序的名称。
在应用程序更新选项下面,指定用新的(已更新的)企业应用程序 .ear 文件替换已安装在服务器上的应用程序。
选择此选项后,执行下列操作:
如果浏览器和更新文件或模块在同一机器上,无论服务器是否在该机器上,使用本地文件系统。本地文件系统可用于所有更新选项。
如果应用程序文件在当前单元上下文中的任何节点上,那么使用远程文件系统。
通过在多服务器安装中使用远程文件系统,如果 Node Agent 或 Deployment Manager 正在所选节点上运行,您可以浏览节点的整个文件系统。只有 .ear、.jar、.sar 或 .war 文件才会在浏览期间显示。
另外使用远程文件系统选项,以指定已在运行应用程序服务器的机器上的应用程序文件。例如,字段值可以是 app_server_install_root/installableApps/test.ear。如果您在安装独立的 WAR 模块,那么还要指定上下文根。
上下文根与已定义的 servlet 映射(包含在 WAR 文件中)共同组成用户访问该 servlet 时需要输入的完整 URL。例如,如果上下文根是 /gettingstarted,并且 servlet 映射是 MySession,那么 URL 是 http://host:port/gettingstarted/MySession。
当更新了完整的应用程序时,卸载旧的应用程序并安装新的应用程序。在保存配置更改并随后进行配置更改同步时,将在要运行该应用程序的节点上展开应用程序文件。如果当更新应用程序时它正在节点上运行,那么停止应用程序、更新应用程序文件并且启动应用程序。
在应用程序更新选项下面,指定替换已安装的应用程序中的模块或者对该应用程序添加模块。
该模块可以是 Web 模块(.war 文件)、企业 bean 模块(EJB .jar 文件)、SIP 模块(.sar 文件)或资源适配器模块(连接器 .rar 文件)。
选择此选项后,指定模块是在本地还是在远程文件系统上,并指定模块的完整路径名。此路径提供已更新模块在安装之前所在的位置。有关本地文件系统和远程文件系统的信息,请参阅先前对替换整个应用程序的描述。
要替换模块,指定相对路径(模块 URI)必须与要在已安装的应用程序中更新的模块的路径匹配。
要对已安装的应用程序添加新模块,指定的相对路径不能与已安装的应用程序中模块路径匹配。此值指定新模块期望的路径。
如果要安装独立的 Web 模块或 SIP 模块,那么指定上下文根的值。上下文根与定义的 servlet 映射(来自 .war 文件)进行组合,以组成用户输入以访问该 servlet 的完整 URL。例如,如果上下文根是 /gettingstarted,并且 servlet 映射是 MySession,那么 URL 是 http://host:port/gettingstarted/MySession。
接着,指定是只显示要求您提供信息的安装选项还是显示所有安装选项。
指定有关模块的必需的信息后,单击下一步显示更新应用程序文件的向导。更新向导与安装向导类似,它提供指定或编辑模块绑定信息的字段。根据需要完成更新向导中的步骤。
在应用程序更新选项下面,指定替换已安装的应用程序中的文件或者对该应用程序添加文件。
使用此选项来更新应用程序使用的文件,该文件不是 .ear、.war、.sar 和 .rar 文件,在某些情况下也不是 .jar 文件。可以使用此选项来添加或更新不是作为应用程序模块定义的 .jar 文件。要更新 .ear 文件,请使用替换整个应用程序选项。要更新定义为应用程序中的模块的 .war 文件、.sar 文件、.rar 文件或 .jar 文件,请使用替换或添加单个模块选项。
选择此选项后,指定文件是在本地还是在远程文件系统上,并指定文件的完整路径名。此路径提供已更新文件在安装之前所在的位置。有关本地文件系统和远程文件系统的信息,请参阅替换整个应用程序的描述。
对于相对路径,请指定从 .ear 文件的根目录开始的文件相对路径。例如,如果文件位于 hello.jar 模块中的 com/company/greeting.class,那么指定相对路径 hello.jar/com/company/greeting.class。
要替换文件,相对路径必须与要在已安装应用程序中更新的文件的路径相匹配。
要对已安装的应用程序添加新文件,其路径一定不能与已安装应用程序中的文件路径相匹配。此值指定新文件期望的路径。
指定文件系统和相对路径后,请单击下一步。
在应用程序更新选项下面,指定通过上载压缩文件更新已安装的应用程序的多个文件。根据压缩文件内容的不同,使用一次此选项就可以对已安装的应用程序替换文件、添加新文件和删除文件。压缩文件中的每个条目都被看作单个文件,而相对于压缩文件根的文件路径被视为该文件在已安装的应用程序中的相对路径。
选择此选项后,指定已压缩文件是在本地还是在远程文件系统上,并指定已压缩文件的完整路径名。您将可能使用本地文件系统,原因是您将上载压缩文件并且远程浏览仅对 .ear、.sar、.war 或 .jar 文件起作用。指定有效的已压缩文件格式,如 .zip 或 .gzip。此路径提供已压缩文件在安装之前所在的位置。此选项将已压缩文件解压缩到已安装的应用程序目录中。
如果浏览器和更新文件或模块在同一机器上,无论服务器是否在该机器上,使用本地文件系统。本地文件系统可用于所有更新选项。
要替换文件,在已压缩文件中的文件必须有与在已安装的应用程序中要更新的文件相同的相对路径。
要将新文件添加到已安装的应用程序,在已压缩文件中的文件必须有与已安装的应用程序中的文件不同的相对路径。
已安装的应用程序中文件的相对路径由模块(如果文件在模块内)的相对路径和来自模块的根的用 / 分隔的文件的相对路径的并置组成。
要删除的文件的级别 | 要包括在压缩文件中的 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,应将 a/b/c.jsp 包括在压缩文件的 my.jar/META-INF/ibm-partialapp-delete.props 文件中。 要在删除模块内的多个文件,在元数据 .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 文件。