部署服务
门户网站部署服务提供了用于访问 Portlet 部署所需配置属性的服务。 Portlet 部署组件负责将 Portlet 集成到门户网站。它将 Portlet 应用程序及其 WAR 文件正确部署到 WebSphere® Portal 和 WebSphere Application Server。它将 WebSphere Application Server 管理服务用于 WebSphere Application Server 中 WAR 文件的实际部署和管理。WAR 文件的管理包括安装、除去、重新部署、启动和停止 Portlet 应用程序。
在 WebSphere Integrated Solutions Console 中,门户网站部署服务列示为 WP DeploymentService。
注意:
- WebSphere
Portal 配置分成两种类型:
- 部署配置。此类型的配置为只读。 始终从文件 portlet.xml 读取部署配置。
- 管理配置。此类型的配置为读和写。
- portlet 应用程序显示在WebSphere Integrated Solutions Console上的企业应用程序列表中。但是,请勿从门户网站外部对它们进行管理。而应该使用管理 Portlet 或门户网站的 XML 配置接口对它们进行管理。对于包含 Portlet 应用程序的 Web 应用程序,您通过其管理名称(也称为显示名称)来进行识别。该名称显示在WebSphere Integrated Solutions Console中。 您可以通过一个特定于门户网站的标识后缀 PA_<name> 来标识此类 Portlet 应用程序的名称。该标识会附加到名称中。这样的名称示例有 PA_WPS_Welcome。接着在安装 Portlet 应用程序时,将从 WAR 文件的名称派生出该名称。您可以使用 Portlet 应用程序的更新来更改此管理名称。
在以下属性列表中,括在括号中的值是缺省值。
- was.admin.host = (localhost)
- WebSphere Application Server 管理主机名。如果缺省值不适用,那么将使用此属性来修改 WebSphere Application Server 引导主机名。
- use.admin.user = (true)
- 当启用门户网站安全性时,使用该关键字在门户网站 Portlet Deployment Manager 的两个用户认证机制之间选择,才通过 WebSphere Application Server 管理服务来进行认证。指定下列两个允许的值中的一个:
- true
- 所有发出 WAR 部署请求的门户网站管理用户共享一个预置用户标识。此值为缺省值。此用户标识是单独的用户标识,对于所有具有安装或管理应用程序访问权的用户都通用。您必须使用WebSphere Integrated Solutions Console用户管理员权限注册该用户标识。
- false
- 使用实际的用户标识,管理员通过该标识发出 WAR 部署请求。每个具有 Portlet 部署权限的门户网站用户都必须添加到具有管理员权限的WebSphere Integrated Solutions Console用户列表中。或者,您可以将整个门户网站管理员组添加到WebSphere Integrated Solutions Console组管理员权限。
- was.notification.timeout = (900)
- 使用此属性可以指定超时值(以秒为单位)。它指定了在管理 WAR 文件期间,部署任务应等待应用程序服务器事件多少秒。在大型的门户网站安装上,可能必须增大该值。
- portletapp.starting.weight = (100)
- 使用此属性可以指定 Portlet 应用程序(WAR 文件)的初始权重值。为了确保初始化顺序正确无误,该值必须高于门户网站本身的初始权重。
- portletapp.shared.library.list
- 此属性定义部署期间添加到每个已部署的 WAR 文件的库引用列表。您可以指定多个引用,用逗号( , )分隔它们。必须已在应用程序服务器中定义了库引用,并且必须已在引用定义中指定的位置上部署了 JAR 文件。
- portletapp.reload.enabled = preserve
- 使用此属性来为已部署的 WAR 文件的重新装入属性定义值。此属性可以有以下值:
- true
- 指定此值可以启用所有 WAR 文件的重新装入方式。 仅将该值用于 Portlet 开发和 Portlet 调试,而不是用于生产环境。
- false
- 指定此值可以禁用所有 WAR 文件的重新装入方式。 此值为缺省值。
- preserve
- 当您指定该值时,会应用 ibm-web-ext.xmi 文件中的设置(如果可用)。
注: 不要在生产环境中启用重新装入。仅为 Portlet 开发和 Portlet 调试启用重新装入。 - discard.config.interval = (60)
- 此属性定义在 WAR 文件保持部署期间所使用配置服务工作空间的最小时间间隔。在该时间到期后,在门户网站运行下一个部署任务时该工作空间将废弃。计量单位为分钟。以下列出有效值及其含义:
- -1
- 从不废弃工作空间。
- 0
- 一旦完成对工作空间的必需操作,就立即废弃该工作空间。
- > 0 (numerical value greater than 0)
- 工作空间废弃之前所保留的时间间隔(以分钟为单位)。然后它用于重新构建下一个部署任务。
注意:- 设置此属性时,使用正确的判断力。正确使用该设置必须兼顾性能和工作空间消耗,原因如下:
- 频繁废弃工作工间对部署性能具有负面影响。安装的门户网站越大,那么废弃和重新构建工作空间就需要越长的时间,以在 WAR 文件部署期间保存配置更改。
- 但是,保留工作空间会将 wp_xxx 临时目录保存在 WebSphere Application Server wstemp 目录中。因此,它们在文件系统中占用的临时空间将随着每次部署 WAR 文件和每次启动门户网站而增加。
- 配置服务工作空间在设置的时间间隔到期后不会立即废弃。在下次调用部署操作时,才执行清除操作。它检查到期的更改并废弃占用的工作空间。如果在上次时间间隔到期和工作空间释放后,发生进一步的部署操作,那么最后分配的工作空间中的更改将保留在门户网站上的文件系统中,即便门户网站关闭也不例外。但是,先前的清除将占用的磁盘空间容量减少到仅为上一次清除时间间隔后处理的临时文件的大小。
通过门户网站中的 Web 模块管理进行 WAR 更新期间,以下属性保护用户使用 WebSphere Integrated Solutions Console
修改的部署设置。
- protect.deployment.attributes = (false)
- 使用此属性可以确定您是否要使用未来门户网站更新覆盖已部署的 Portlet WAR 文件的现有 Web 模块属性。更新 WAR 文件期间,门户网站部署功能观察为此服务定义的值。但是,用户稍后可以通过脚本编制或使用
WebSphere Integrated Solutions Console 来修改已部署的 WAR 的属性。例如,用户可以修改为个别 WAR 文件装入类装入器的顺序。您可以使用此属性来保护此类修改,并通过门户网站 Web 模块部署功能来防止这些修改被覆盖。有效值如下:
- false
- 如果您不想保护 WAR 文件修改,请指定 false。此值为缺省值。
- true
- 要保护对 WAR 文件的修改,请指定 true。
文件位置定义:以下值定义了文件位置。所有这些设置都有缺省值。
仅当缺省值不适用时,才能启用或修改它们。
- delete.temp.files = (true)
- 此属性确定是删除还是保留部署期间在 application.repository.dir.name/temp 目录下创建的临时文件。缺省值为 true,这意味着这些文件已删除。只在为了进行调试时,才将此值更改为 false,这样,您就可以查看临时扩展的 WAR 文件的内容。 当您完成调试时,将值更改回 true,并手动删除目录。如果您将值更改为 false,那么要知道临时目录所需的硬盘驱动器空间会随您添加或更新的每个 WAR 文件而增长。
- shorten.deployment.names = (true)
- 使用此键在部署期间使文件名更加简短。一些平台(如 Windows)对文件路径的长度加以限制。如果结果路径过长,那么过长的文件路径可能导致部署失败。
- deployment.names.limit = (21)
- 此值是 Portlet 应用程序文件和显示名的阈值。如果需要,缩短较长的名称。
以下设置仅用于调试目的。仅当支持人员指示进行调试时才启用该设置。
- deployment.debug.log.times = (false)
- 此设置仅用于调试目的。仅当支持人员指示进行调试时才启用该设置。