存档

文章标签 ‘websphere’

软硬兼施 优化 WebSphere Application Server

2010年2月21日 hashei 没有评论

之前看的很多was优化案例,包括自己实施过程中都只从WebSphere的角度来考虑问题,虽然WAS的优化中包括了操作系统层面的优化,比如对AIX、HPUX的系统参数做出调整,对于网络tcp的参数做出改动,但并没有更进一步,在进行LPAR分区前就做出完整的规划。

WebSphere管理员和硬件与操作系统管理员往往交流不多,且是串行的实施顺序。虽说也就那么做下来了,但是是否充分发挥了硬件的资源,是否达到了最好的性能,最稳定的运行,还是可以有改进的余地?都值得探讨。IBM网站上这三篇文章可谓打通了两种管理员之间的任督二脉,看懂了总有好处。

本书提供了整体系统观点,重点关注在 Power System 和 AIX 上运行 WebSphere Application Server 负载的环境的端到端系统部署、调优和管理方法。因而,本书为两类截然不同的技术读者架起了一座桥梁,也就是硬件和操作系统管理员与 WebSphere Application Server 应用软件工程师。我们都了解,在典型的企业环境中,这两类技术读者需要密切合作,但仍然有着不同的视角和职责。然而,对于企业来说,在度量 Power System 和 AIX 上运行的 WebSphere Application Server 投资的成败时,最终要取决于所有系统架构师能否很好地理解如何同心协力地利用每种产品的特有优势。因而,我们首先要做的是澄清各种观点。

在 Power System 上优化 WebSphere Application Server,第 1 部分: 入门以及优化策略

在 Power System 上优化 WebSphere Application Server,第 2 部分: 设置 Power System 硬件和分区(上)

在 Power System 上优化 WebSphere Application Server,第 3 部分: 设置 Power System 硬件和分区(下)

有空么可以再看看《WebSphere Application Server V6.1 Planning and Design WebSphere Handbook Series》

IBM WebSphere最新技术支持信息

2009年12月20日 hashei 1 条评论

如果你想订阅这个邮件列表,发送邮件到wsehelp@us.ibm.com即可,邮件名称标注“subscribe WebSphere Application Server”

WebSphere Application Server Customer,
As a valued WebSphere Application Server customer who has contacted technical support, we are hoping you will find this information useful.
This note contains links to WebSphere Application Server technical support documents and information that can help you obtain value from your software. It is intended to help you to be proactive in your support and administration of WebSphere Application Server.

    • 1. Don’t be caught by surprise – try the IBM Support Portal today
      On January 6 the new IBM Support Portal, a unified, centralized view of all technical support tools and information for all IBM software, replaces the existing software product support pages. You can tailor the Support Portal to suit your needs, focusing on the software and hardware products you care about and organizing the pages to reflect the way you work. The portal makes it fast and easy to find the information or tools you need to prevent and resolve problems.We hope you can take a few minutes to fill out a short questionnaire that evaluates the IBM Support Portal in comparison to the existing IBM support website pages. We appreciate your feedback!
      2. IBM WebSphere Application Server Migration Toolkit
      The IBM WebSphere Application Server Migration Toolkit helps organizations migrate applications from other application servers to IBM WebSphere Application Server. WebSphere Application Server, a Java EE 5 certified, EJB 3.0 supported technology-based application platform, is a key part of the IBM Smart SOA Application Foundation that delivers the innovation and performance essential to cost-effectively build, deploy and manage robust SOA applications.
      http://www.ibm.com/developerworks/websphere/downloads/migration_toolkit.html
      3. developerWorks: WebSphere Application Server security
      This page of essential resources contains hints, tips, and valuable guidance to help you configure and use WebSphere Application Server security more effectively, and to design and develop your WebSphere Application Server solutions in ways that will make them more secure. Also included is information on the security environment in which WebSphere Application Server resides.
      http://www.ibm.com/developerworks/websphere/zones/was/security/
      4. Follow WebSphere Support on Twitter
      A list of available Twitter accounts for WebSphere Support.
      http://www.ibm.com/support/docview.wss?rs=180&uid=swg21410956
      5. WebSphere Application Server Feature Pack for XML
      The IBM WebSphere Application Server V7 Feature Pack for XML delivers updated XML programming model standards to help improve developer productivity and address new application development scenarios.
      http://www.ibm.com/software/webservers/appserv/was/featurepacks/xml/
      6. IBM Support Assistant – helping you simplify support
      If you haven’t tried the IBM Support Assistant yet, use the Quick Start Guide to find out what you’re missing! Save time with automated collectors and over 20 robust problem determination tools. IBM Support Assistant can be customized for over 350 IBM software products. The ISA Lite offering lets you quickly use the accurate, automated data collection capability. Download the workbench or ISA Lite to simplify support and save time. Not sure which one you need? Use the handy chart on the page to help you decide.
      7. The Support Authority: Know what your Web application is really doing
      The IBM Monitoring and Diagnostic Tools for Java – Health Center is a lightweight tool that monitors IBM virtual machines for Java with minimal performance overhead. It provides live information and recommendations about classes being loaded, the virtual machine environment, garbage collection, locking, and profiling. This article introduces you to the Health Center and shows an example of how it can be used to check the impact of a source code change in a Web application.
      http://www.ibm.com/developerworks/websphere/techjournal/0911_supauth/0911_supauth.html
      8. The Support Authority: Analyze memory management problems with the Memory Dump Diagnostic for Java (MDD4J)
      The Memory Dump Diagnostic for Java (MDD4J) tool helps you diagnose memory leaks and other excessive memory consumption problems in applications running in IBM Java Virtual Machines (JVMs). This article introduces you to MDD4J and shows you how to use its sophisticated analysis engine and user interface to peer into the Java heap so you can see which objects are consuming the most amount of memory.
      http://www.ibm.com/developerworks/websphere/techjournal/0909_supauth/0909_supauth.html
      9. One plug-in config to handle multiple Portal Applications in multiple Portal Clusters
      I have different Portal applications running in 2 different Portal Clusters. I want to use only 1 IBM HTTP Server Web server to route requests correctly for both applications in both clusters. How can I configure the Web server plug-in to accomplish this?
      http://www.ibm.com/support/docview.wss?rs=180&uid=swg21397408
      10. Web server plug-in routing to SAME application in DIFFERENT clusters
      If I install the same Web application into more than one WebSphere Application Server cluster, is it possible to configure the Web server plug-in to properly route requests to the application in both clusters?
      http://www.ibm.com/support/docview.wss?rs=180&uid=swg21331062
      11. IBM Service Integration Bus Destination Handler, Version 1.1
      A tool to view, move, copy, delete, save and restore messages in the default messaging provider for IBM WebSphere Application Server versions 7.0, 6.1, and 6.0.
      http://www.ibm.com/support/docview.wss?rs=180&uid=swg24021439
      12. Solution for installing 32-bit Java SDK fix packs on IBM HTTP Server V7.0 using Update Installer 7.0.0.5 and earlier
      For most operating systems and architectures, you should install the 32-bit Java SDK fix packs for IBM HTTP Server V7.0, even if that IBM HTTP Server was installed from the 64-bit Supplemental installation image. However, due to a defect in the process, Update Installer V7.0.0.5 and earlier will not allow you to install the 32-bit Java SDK fix pack, and will erroneously allow you to install the 64-bit Java SDK fix pack instead. This technote explains how to address this problem.
      http://www.ibm.com/support/docview.wss?rs=180&uid=swg21395882

      1. WebSphere Application Server Administration Using Jython
      Utilizing Jython scripting, you can dramatically reduce the effort, resources, and expense associated with managing WebSphere Application Server. WebSphere Application Server Administration Using Jython will show you how. The first start-to-finish guide to Jython scripting for WebSphere administration, this book’s practical techniques and downloadable scripts can help you improve efficiency, repeatability, and automation in any WebSphere environment.
      *Using coupon code IBM9527 provides you a 35% discount AND Free Shipping!
      http://www.ibmpressbooks.com/bookstore/product.asp?isbn=0137009526
      2. Join us for these Electronic Support webcasts
      During the month of January, the Global WebSphere Community will offer a series of four electronic support webcasts. Check the web site for details on joining the webcasts:
      January 7 webcast – “It’s official – the IBM Support Portal is here!”
      January 14 webcast – “Quick guide to electronic support and a close look at the Service Request tool”
      January 21 webcast – “Discover IBM Support Assistant – ready to help when you need it”
      January 28 webcast – “IBM portfolio of troubleshooting tools: helping you solve problems faster”
      3. IBM WebSphere Application Server V7.0 Web Services Guide
      This IBM Redbooks publication describes how to implement Web services in IBM WebSphere Application Server V7. It starts by describing the concepts of the major building blocks on which Web services rely and leading practices for Web services applications.
      http://www.redbooks.ibm.com/abstracts/SG247758.html
      4. Technical Exchange Webcasts
      Take full advantage of your product. Join us as technical experts share their knowledge and then answer your questions. Visit this site often to see upcoming topics.
      http://www.ibm.com/software/websphere/support/supp_tech.html
      5. Self-Assist Resources and Tools
      Find out how online software support tools and resources can save you time, keep you informed, provide training, and help streamline your support experience!
      http://www.ibm.com/software/websphere/support/d2w.html
      6. developerWorks WebSphere Application Server zone
      Access the developerWorks page for downloads, learning resources and more.
      http://www.ibm.com/developerworks/websphere/zones/was/
  • In the spotlightPlan

    Education

Kind regards,
The WebSphere Application Server team.

WebSphere为应用程序设置访问认证

2009年11月24日 hashei 没有评论

《WAS启用IHS的SSL》一文中,我给出了两个PDF,详细描述了如何在IBM Http Server上启用SSL,为用户提供安全的传输通道。但有些应用不仅要实现加密传输,还需要认证功能,比如使用数字证书,或者实体的USB Key。本文就是讲述在这种环境下如何配置,为单独的WAS服务器,没有结合IHS。参考文档《IBM WebSphere Application Server V6.1 Security Handbook》(sg246316)

 

步骤一:配置“密钥库和证书”

注意:配置前请先将密钥文件放置在对应profile的etc目录下

websphere ssl key management
在管理控制台的“安全性”——“SSL证书和密钥管理”里,点击最右边的“密钥库和证书”。

会看到已经有三个默认的密钥库存在,点击新建:

阅读全文…

分类: Websphere系列, 安全 标签: , ,

IBM WebSphere Recent Supports

2009年9月18日 hashei 没有评论

This note contains links to WebSphere Application Server technical support documents and information that can help you obtain value from your software. It is intended to help you to be proactive in your support and administration of WebSphere Application Server.

一次WebSphere性能问题诊断过程

2009年8月24日 hashei 没有评论

一次接到用户电话,说某个应用在并发量稍大的情况下就会出现响应时间陡然增大,同时管理控制台的响应时间也很慢,几乎无法进行正常工作。

赶到现场后,查看平台版本为Webshpere6.0.2.29,操作系统为Windows 2003企业版sp2,于是首先分析systemout.log,发现有如下报错:

= com.ibm.websphere.ce.j2c.ConnectionWaitTimeoutException Max connections reached 869

Exception = com.ibm.websphere.ce.j2c.ConnectionWaitTimeoutException

Source = Max connections reached

probeid = 869

同时也发现有“Caused by: java.io.IOException: Async IO operation failed, reason: RC: 10053 您的主机中的软件放弃了一个已建立的连接。”

很明显是连接池无法分配一个新连接给请求,wait时间过长达到WaitTimeout时间,第一反应是数据库连接池大小开的不够,于是设成初始50,最大150,120S空闲则自动释放连接。

但是调整参数后没有改善,过了不到10分钟应用依旧变慢。再次查看System.out和FFDC里的错误信息,发现有许多关于IO的报错:

com.ibm.ws.webcontainer.channel.WCCByteBufferInputStream 102

Exception = java.net.SocketTimeoutException

Source = com.ibm.ws.webcontainer.channel.WCCByteBufferInputStream

probeid = 102

stack Dump = java.net.SocketTimeoutException: Async operation timed out

java.io.IOException com.ibm.ws.webcontainer.servlet.RequestUtils.parsePostData 398

Exception = java.io.IOException

Source = com.ibm.ws.webcontainer.servlet.RequestUtils.parsePostData

probeid = 398

Stack Dump = java.io.IOException: Async IO operation failed, reason: RC: 55 指定的网络资源或设备不再可用。probeid = 1184

事后才知道其实数据库和中间件之间的问题,但是一来没有报连接池大小不够的错,二来此时管理控制台也几乎无法使用,又结合此应用在操作中会上传许多文件并进行校验,怀疑是服务器的I/O瓶颈导致应用变慢。

        于是在服务器上开启性能工具,添加%Disk time、%Disk Write、%Disk Read、Disk Queue Length、Fage Fault等计数器。发现%Disk Time平均维持在20~70之间,瞬时的Disk Time会达到90多,而且Disk Read值很小,基本是Disk Write。

继续观察了一段时间,发现当磁盘读写下来后,应用还是很慢,于是分析内存回收情况,查看是否有内存泄漏发生。

用IBM Monitoring and Diagnostic Tools for Java™ – Garbage Collection and Memory Visualizer分析发现 Mean interval between collections只有0.46分钟,且内存使用量才250多M就开始GC,而内存参数设置为760~1260M,于是分析内存中的碎片太多,导致GC频繁,使服务的响应速度变慢。同时分析软件得出The mean heap unusable due to fragmentation is estimated at 34.685%,问了应用他们申请内存对象一般是短期的,于是更改GC Policy为Gencon(分代并发),再观察GC日志发现每次回收间隔都较长,而且是young区的回收,Global collections间隔为23分钟。

可惜做了如此的性能优化,情况一点都未改善,在控制台的性能实时检测中可以看到JDBC连接有40~60个繁忙状态,当时无法确定这是否正常,是否是确实需要用到如此多连接。后来应用开发的检测数据库,发现很多active的连接时间长达5到10分钟,内容为一查询语句。原来应用是在Hibernat下开发的,查询语句被它加了自己的函数,导致原先建的索引无法起作用(应用建立索引的时候犯了低级错误),后来重新建立索引后,查询很快完成,连接池繁忙数量降低到0~5,应用恢复正常。原来是数据库的查询时间过长,导致线程都在等待数据库的返回信息,100个线程很快被用完,无法响应新的服务,因为数据库连接池资源已经开大,所以没有这方面的报错。

回顾这一周的排错过程,走了很大的弯路,当时因为经验欠缺没有想到做thread dump,如果做了thread dump的话,应该很容易看到大量的线程在等待数据库的返回,从而定位到数据库问题。

从中我们也看到,最终的问题也许很低级,但是排查的过程会很复杂,因为中间件问题牵扯到主机、网络、数据库、应用等各方面。不过得到的经验就是,在应用响应慢的时候,应该做个thread dump观察线程运行情况,而并非要等到hang住,cpu 100%,OutOfMemory的时候才想起分析javacore。

WebSphere下应用程序更新

2009年7月25日 hashei 4 条评论

先介绍我们常用的直接上传方法

一般来讲,单机版的was,应用程序部署在 %washome%/profiles/%AppProfile%/installedApps下,根新的时候可以直接把新文件上传到这个目录相应位置,但是如果要改动web.xml等重要文件,还需要修改另外一个地方:%washome%/profiles/%AppProfile%/config/cells/CellName/applications/AppName,这里放有包括web.xml等一些配置文件信息,千万不能遗忘(可以先看一下这目录下有些什么文件),否则重启应用后修改不会生效

如果是ND环境的was,并且做了集群,那么要注意集群所在的每个app profiles下都有installedApps应用程序目录需要修改,同样config下相应文件需要修改(如果有对这目录下的文件进行过修改的话),还一定要注意dm profile的config目录下也需要修改,否则重启dm后所有修改会回滚会最初的样子。最好把变动过的web.xml等文件也更新到dm config下的应用程序包中,我遇到过即使修改config目录下文件,重启dm节点后依然回滚的情况。

Websphere也支持通过控制台更新和删减单个应用文件

这是WebSphere推荐的方法,但是大家不常用罢了,有兴趣的可以看看,聊当多知道一种方法。

要查看此管理控制台页面,单击应用程序 > 企业应用程序

要查看为应用程序的配置指定的值,单击列表中的应用程序名。显示的应用程序设置页显示已指定的值。在设置页上,您可以更改现有的配置值并且链接到可以协助您配置应用程序的其他控制台页面。

要管理已安装的 J2EE 企业应用程序,启用列表中的应用程序名旁边的选择复选框,然后单击按钮:

按钮

结果操作

启动

试图运行应用程序。在成功启动应用程序之后,如果应用程序在所有部署目标上启动,则应用程序的状态更改为已启动,其他情况下,状态更改为部分已启动

停止

试图停止应用程序的处理。在成功停止应用程序之后,如果应用程序在所有部署目标上停止,则应用程序的状态更改为已停止,其他情况下,状态更改为部分已停止

安装

打开可帮助您将应用程序或模块(如 .jar、.war 或 .rar 文件)部署到服务器或集群的向导。

卸载

从 WebSphere Application Server 配置库删除应用程序,并且从所有节点的文件系统删除应用程序二进制文件,而这些节点是配置被保存和与节点同步之后安装应用程序模块的节点。

更新

打开可帮助您更新部署在服务器上的应用程序文件的向导。您可以更新整个应用程序、单个模块、单个文件或一部分应用程序。如果新的文件或模块与服务器上已有的文件或模块同名,则新的文件或模块将替换现有文件或模块。如果服务器上还不存在该新的文件或模块,则将它添加到已部署应用程序。

更新应用

继续更新跨越一个集群安装在多个集群成员上的应用程序。在您更新应用程序的文件或配置之后,单击更新应用,以在安装应用程序的集群的所有集群成员上安装应用程序的已更新文件或配置。更新应用依次为每个集群成员执行下列操作:

  1. 保存已更新的应用程序配置。
  2. 停止一个节点上的所有集群成员。
  3. 通过同步配置更新节点上的应用程序。
  4. 重新启动已停止的集群成员。
  5. 为所有具有集群成员的节点重复步骤 2 到 4。

此操作在提供应用程序的持续可用性的同时,更新多个集群成员上的应用程序。

除去文件

删除已部署应用程序或模块的文件。除去文件从 WebSphere Application Server 配置库和从安装文件的所有节点的文件系统中删除文件。 如果在集群上部署了应用程序或模块,则在除去文件后,单击更新应用以首次展示跨整个集群的更改。

导出

访问“导出应用程序 EAR 文件”页,您可以使用该页面将企业应用程序导出到您选择的位置上的 EAR 文件。使用导出操作备份已部署应用程序并且保存它的绑定信息。

导出 DDL

访问“导出应用程序 DDL 文件”页,您可以使用该页面将企业应用程序的 EJB 模块中的 DDL 文件(Table.ddl)导出到您选择的位置。

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

要查看此管理控制台页面,完成下列步骤:

  1. 单击应用程序 > 企业应用程序
  2. 选择您要更新的已安装的应用程序或模块。
  3. 单击更新

单击更新显示帮助您更新部署在单元中的应用程序文件的页面。您可以更新整个应用程序、单个模块、单个文件或一部分应用程序。如果新的文件或模块与服务器上已有的文件或模块具有相同的相对路径,则新的文件或模块将替换现有文件或模块。如果服务器上还不存在该新的文件或模块,则将它添加到已部署应用程序。

应用程序名

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

完整的应用程序

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

选择此选项后,指定 .ear 文件是在本地还是在远程文件系统上,并指定应用程序的完整路径名。此路径在安装前提供已更新的 .ear 文件的位置。

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

如果应用程序文件驻留在当前单元上下文的任何节点上,使用远程文件系统。 如果 Node Agent 或 Deployment Manager 正在所选节点上运行,您可以浏览节点的整个文件系统。浏览期间,仅显示 .ear、.jar 或 .war 文件。另外使用远程文件系统选项,以指定已在运行应用程序服务器的机器上的应用程序文件。例如,Windows 机器上的字段值可能是 C:\WebSphere\AppServer\installableApps\test.ear。

注: 应用程序安装期间,通常从运行浏览器的客户机将应用程序文件上载到部署它们的、在运行管理控制台的服务器上。在这些情况下,使用运行管理控制台的 Web 浏览器选择 .ear、.war 或 .jar 模块,以上载到服务器。然而在某些情况下,应用程序文件驻留在单元中的任何节点的文件系统上。要让应用程序服务器安装这些文件,使用远程文件系统选项。

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

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

单个模块

更新选项下,指定替换在已安装的应用程序中的模块,或将模块添加到已安装的应用程序。模块可以是 Web 模块(.war 文件)、Enterprise Bean 模块(EJB .jar 文件)或资源适配器模块(连接器 .rar 文件)。

选择此选项后,指定模块是在本地还是在远程文件系统上,并指定模块的完整路径名。此路径在安装前提供已更新模块的位置。要获取有关本地文件系统远程文件系统的信息,请参阅以上完整的应用程序的描述。

要替换模块,模块的相对路径(模块 URI)的值必须与要在已安装的应用程序中更新的模块的路径匹配。

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

如果您正在安装独立的 Web 模块,则指定上下文根的值。上下文根与定义的 servlet 映射(来自 .war 文件)进行组合,以组成用户输入以访问该 servlet 的完整 URL。例如,如果上下文根是 /gettingstarted 并且 servlet 映射是 MySession,则 URL 是 http://host:port/gettingstarted/MySession。

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

在添加或更新了单个模块后,当保存配置更改时,新的或更新的模块被存储到 WebSphere Application Server 配置存储库的已部署应用程序中。当这些更改与节点一起同步时,模块被添加或更新到节点的文件系统中。如果当添加或更新模块时应用程序正在节点上运行,则发生下列某个情况:

· 对于到 Web 模块的更新,停止正在运行的 Web 模块,更新 Web 模块文件然后启动 Web 模块。

· 对于模块增补,在节点上扩展添加的模块之后,在运行应用程序的应用程序服务器上启动这个添加的模块。不需要重新启动应用程序。

· 如果应用程序的类装入器策略设置为单个以使所有的模块共享一个类装入器,则对于模块级别更改,停止和重新启动整个应用程序。

· 如果与 WebSphere Application Server 一起配置的 Security Provider 不支持动态更新,则对于模块级别更改,停止和重新启动整个应用程序。

· 对于模块的其他更新,停止整个应用程序,更新模块文件,然后启动更个应用程序。

单个文件

更新选项下,指定替换在已安装的应用程序中的文件,或将文件添加到已安装的应用程序。

使用此选项更新应用程序使用的并且不是 .ear、.war、.rar 或某些情况下 .jar文件的文件。您可以使用此选项添加或更新不是作为应用程序中模块定义的 .jar 文件。要更新 .ear 文件,使用完整的应用程序选项。要更新作为应用程序中模块定义的 .war 文件、.rar 文件或 .jar 文件,使用单个模块选项。

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

下一步,指定文件的相对路径的值。文件的相对路径必须从 .ear 文件的根开始。例如,如果文件位于 hello.jar 模块中的 com/company/greeting.class,则指定 hello.jar/com/company/greeting.class 的相对路径。

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

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

在添加或更新了单个文件后,当保存配置更改时,新的或更新的文件被存储到 WebSphere Application Server 配置存储库的已部署应用程序中。当这些更改与节点一起同步时,文件被添加或更新到节点的文件系统中。如果当添加或更新文件时应用程序正在节点上运行,则发生下列某个情况:

· 在应用程序元数据作用域(META-INF 目录)上添加文件时,或在任何应用程序作用域上或非 Web 模块中更新这些文件时,停止整个应用程序,添加或更新文件,然后重新启动整个应用程序。

· 在应用程序非元数据作用域(在 META-INF 目录外但不在任何模块中)上添加文件时,在不重新启动运行应用程序的情况下在文件系统中保存更改。

· 当文件添加到或更新到 Web 模块元数据(META-INF 或 WEB-INF 目录)时,停止运行的 Web 模块,添加或更新 Web 模块文件,然后启动此 Web 模块。

· 对于 Web 模块中的所有其他文件,在节点的文件系统上添加或更新文件,而没有停止应用程序或任何其组件。

部分应用程序

更新选项下,指定通过上载压缩文件更新已安装的应用程序的多个文件。根据已压缩文件的内容,单独使用此操作可以替换已安装的应用程序的文件,将新文件添加到已安装的应用程序或从该用程序将文件删除。在已压缩文件中的每个条目都作为单个文件对待,而来自已压缩文件的根的文件的路径都作为在已安装的应用程序中的文件的相对路径对待。

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

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

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

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

已安装的应用程序中文件的相对路径由模块(如果文件在模块内)的相对路径和来自模块的根的用 / 分隔的文件的相对路径的并置组成。

要从已安装的应用程序除去文件,使用在任何归档作用域中名为 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.class 。

要在模块内删除多个文件,在元数据 .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。