使用 wsadmin 脚本编制来管理组合单元
使用 BLAManagement 命令组中的命令来管理组合单元。使用本主题中的示例来添加、移除、编辑、导出和查看组合单元。
开始之前
可通过两种方法来完成本任务中的示例。使用 AdminTask 对象的 BLAManagement 命令组来管理组合单元。或者,您可以使用 AdminBLA 脚本库中的脚本来管理组合单元配置。
关于此任务
组合单元可以代表已部署的资产、其他业务级应用程序或外部工件(已在非 WebSphere® Application Server 运行时环境上部署,但无关联资产)。业务级应用程序包含零个或更多的组合单元。无法将同一组合单元添加到多个业务级应用程序,但您可以使用一个资产来创建多个组合单元。
过程
- 添加组合单元。
- 启动 wsadmin 脚本编制工具。
- 添加组合单元。 使用 addCompUnit 命令将组合单元添加到业务级应用程序。注: 如果资产是企业捆绑软件归档 (EBA) 资产,那么还要设置其他参数。使用以下命令示例将 asset1 资产添加为 myBLA 业务级应用程序中的组合单元,并将部署映射到 server1 服务器:
AdminTask.addCompUnit('-blaID myBLA –cuSourceID asset1 -CUOptions [[.* .* compositionUnit1 "composition unit that is backed by asset1" 0]] -MapTargets [[.* server1]] –ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
使用以下命令将 asset2 资产添加为 myBLA 业务级应用程序中的组合单元,并将部署映射到 server1 和 testServer 服务器:AdminTask.addCompUnit('-blaID myBLA –cuSourceID asset2 -CUOptions [[.* .* compositionUnit2 "composition unit that is backed by asset2" 0]] -MapTargets [[.* server1+testServer]] –ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
使用以下命令将 J2EEAsset 资产添加为 myBLA 业务级应用程序中的组合单元,并将部署映射到 server1 和 testServer 服务器:AdminTask.addCompUnit('[-blaID myBLA –cuSourceID J2EEAsset –defaultBindingOptions defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host# defaultbinding.force=yes –AppDeploymentOptions [-appname defaultapp -installed.ear.destination application_root/myCell/defaultapp.ear] –MapModulesToServers [[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1][Increment.jar .* Websphere:cell=cellName,node=nodeName,server=testServer]] -CtxRootForWebMod [[defaultapp.war .* myctx/]]]')
如果要编辑组合单元以更新某个共享库,那么必须先手动停止所有基于该共享库的 Java EE 应用程序。更新该共享库后,请手动重新启动这些 Java EE 应用程序。共享库更新后,Java EE 应用程序不会自动重新启动。
此命令会返回组合单元的配置标识以及在资产关系中为资产创建的新组合单元,如以下示例所示:WebSphere:cuname=compositionUnit1 WebSphere:cuname=compositionUnit2 WebSphere:cuname=J2EEAsset
- 保存配置更改。 请使用以下命令示例来保存配置更改:
AdminConfig.save()
- 显示组合单元和配置设置。
使用 listCompUnits 和 viewCompUnits 命令来显示与特定搜索范围相匹配的每个组合单元的配置标识。
您可以使用 listCompUnits 命令来显示配置中或特定业务级应用程序中的每个组合单元。以下示例会显示 myBLA 业务级应用程序中的每个组合单元:AdminTask.listCompUnits('-blaID blaname=myBLA')
此命令会返回与搜索范围相匹配的每个组合单元的配置标识和后备资产类型,如以下样本所示:Websphere:cuname=cu1 asset Websphere:cuname=cu4 bla WebSphere:cuname=defaultapp __j2ee
您可以使用 viewCompUnits 命令来显示有关业务级应用程序的特定组合单元的其他配置信息。例如,以下示例会显示有关 myBLA 业务级应用程序的 cu1 组合单元的其他信息:AdminTask.viewCompUnit('-blaID myBLA -cuID cu1')
此命令会返回组合单元的详细配置信息,如以下样本所示:Specify Composition Unit options (CUOptions) Specify name, description options for Composition Unit. Parent BLA (parentBLA): [WebSphere:blaname=myBLA] Backing Id (backingId): [WebSphere:assetname=asset1.zip] Name (name): [cu1] Description (description): [my description of cu1 composition unit] Starting Weight (startingWeight): [0] Specify servers (MapTargets) Specify targets such as application servers or clusters of application servers where you want to deploy the composition unit contained in the application. Deployable Unit (deplUnit): [default] *Servers (server): [WebSphere:node=myNode,server=server1] Specify Composition Unit activation plan options (ActivationPlanOptions) Specify composition unit activation plan optionsDeployableUnit Name (deplUnit): [default] Activation Plan (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1]
如果组合单元包含企业捆绑软件归档 (EBA) 资产,那么还将显示组合单元状态。此状态是下列其中一个值:- 使用最新的 OSGi 应用程序部署。
- 新 OSGi 应用程序部署尚不可用,因为它需要的捆绑软件仍在下载。
- 新的 OSGi 应用程序部署可用。
- 无法应用新 OSGi 应用程序部署,因为捆绑软件下载失败。
- 编辑组合单元。
- 启动 wsadmin 脚本编制工具。
- 修改组合单元。 使用 editCompUnit 命令来修改组合单元选项。您可以使用此命令来修改组合单元的启动权重、部署目标、激活计划选项以及关系设置。请参阅“AdminTask 对象的 BLAManagement 命令组”的文档,以查看您可以修改的每个选项的描述。注: 如果组合单元包含企业捆绑软件归档 (EBA) 资产,那么您可以修改其他参数。以下示例会编辑与资产相关联的组合单元,并替换部署目标:
AdminTask.editCompUnit('-blaID myBLA –cuID cu1 –CUOptions [[.* .* cu1 cudesc 1]] -MapTargets [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
此命令会返回系统所编辑的组合单元的配置标识,如以下样本所示:WebSphere:cuname=cu1
- 保存配置更改。 请使用以下命令示例来保存配置更改:
AdminConfig.save()
- 移除组合单元。
- 启动 wsadmin 脚本编制工具。
- 移除组合单元。 使用 deleteCompUnit 命令来移除组合单元。只要系统可以将不完整的配置标识与唯一标识相匹配,此命令的两个参数就可以接受此不完整的配置标识:
AdminTask.deleteCompUnit('-blaID myBLA –cuID cu1')
此命令会返回系统所删除的组合单元的配置标识,如以下样本所示:WebSphere:cuname=cu1
- 保存配置更改。 请使用以下命令示例来保存配置更改:
AdminConfig.save()
相关任务:


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7managecu
文件名:txml_7managecu.html