使用 wsadmin 脚本编制的 AdminTask 对象的 BLAManagement 命令组
可以使用 Jython 脚本编制语言,通过 wsadmin 工具来配置和管理业务级应用程序。 使用 BLAManagement 组中的命令和参数,在配置中创建、编辑、导出、删除以及查询业务级应用程序。
要配置和管理业务级应用程序,您必须使用“配置员”管理角色。
deleteAsset
deleteAsset 命令用于从业务级应用程序配置中移除资产。 在使用此命令之前,请验证未将任何组合单元与相关资产相关联。 如果该资产已与组合单元相关联,那么此命令将失败。
目标对象
无
必需参数
- -assetID
- 指定要删除的资产的配置标识。 只要系统可以将 assetID 参数的不完整标识与唯一资产相匹配,此命令就可以接受不完整标识。 (字符串,必需)
可选参数
- -force
- 指定即使其他资产依赖于此资产,是否仍要强制系统删除此资产。 (布尔值,可选)
返回值
WebSphere:assetname=asset2.zip
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.deleteAsset('-assetID asset2.zip -force true')
- 使用 Jython 列表:
AdminTask.deleteAsset(['-assetID', 'asset2.zip', '-force', 'true'])
交互方式示例用法
- 使用 Jython:
AdminTask.deleteAsset('-interactive')
editAsset
editAsset 命令会修改其他资产配置选项。 可以使用此命令来修改描述、目标 URL、资产关系、文件许可权以及验证设置。
目标对象
无
必需参数
- -assetID
- 指定要编辑的资产的配置标识。 只要系统可以将不完整的配置标识与唯一资产标识相匹配,此参数就可以接受不完整的配置标识。 (字符串,必需)
可选步骤
.*
字符来指定只读自变量。 使用 ""
字符指定空字符串,以保留自变量的现有值。 如果没有为可写参数指定值或空字符串,那么该命令会将该参数重置为空值。- -AssetOptions
- 使用 AssetOptions 步骤和以下参数来设置资产的其他属性。
- inputAsset(只读)
- 指定资产的源程序包。
- name(只读)
- 指定资产的名称。 此参数的缺省值为源程序包的文件名。
- defaultBindingProps(只读)
- 指定资产的缺省绑定属性。 此参数仅适用于企业资产。 对于不是企业资产的资产,请指定星号字符 (*) 以进行模式匹配。 对于企业资产,请指定
.*
值以将此参数设置为非空值。 - 描述
- 指定资产的描述。
- destinationUrl
- 指定要部署的资产二进制文件的 URL。
- typeAspect
- 指定资产类型侧重面。
- 关系
- 指定资产关系。 使用加号字符 (+) 将其他资产添加到现有关系。 使用编号符号字符 (#) 从关系中删除现有资产。 要替换现有关系,请指定 importAsset 命令中所指定的相同语法。 如果关系中指定的资产不存在用于添加或更新,那么该命令将返回异常。
- filePermission
- 指定文件许可权配置。
- validate
- 指定是否要验证资产。 缺省值为
false
。 产品没有保存针对 validate 指定的值。 因此,如果选择现在验证资产 (true
) 并稍后编辑该资产,那么在您编辑该资产时,必须再次启用此设置,才能让产品验证所更新的文件。
- -UpdateAppContentVersions
- 对于 EBA 资产,使用此步骤和下列自变量来选择资产的捆绑软件版本。对于转换用户: 在 WebSphere® Application Server V 7 Feature Pack for OSGi Applications and Java™ Persistence API 2.0中,通过重新启动业务级应用程序来应用对资产的捆绑软件更改。 在 V8.x 中,通过更新组合单元来应用这些更改。 V 8.x 中的新方法意味着可以就地应用许多捆绑软件更改,而无需重新启动正在运行的业务级应用程序。 要启用此新方法, UpdateAppContentVersionsStep 参数已替换为 UpdateAppContentVersions 参数,您将运行带有 CompUnitStatusStep 参数的 editCompUnit 命令,而不是重新启动业务级应用程序。
- bundle_name
- 指定捆绑软件的名称。
- current_version
- 指定在应用程序清单中声明但未由运行时环境部署的共享捆绑软件 (即 使用捆绑软件) 的捆绑软件版本号 (例如
1.0.0
) 或NOT_DEPLOYED
。 此自变量描述了捆绑软件的当前配置,但不用于更改配置。 - update_preference
- 指定新的捆绑软件版本首选项。 这是捆绑软件版本号(例如,
1.0.0
)或NOT_DEPLOYED
(对于共享捆绑软件)或NO_PREF
(如果希望系统为您选择捆绑软件版本)。 如果不希望更新给定的捆绑软件的版本,那么将此属性设置为与 current_version 属性使用相同的值。
返回值
此命令会返回相关资产的配置标识。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.editAsset('-assetID asset3.zip -AssetOptions [[.* asset3.zip * "asset for testing" c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]')
- 使用 Jython 列表:
AdminTask.editAsset(['-assetID', 'asset3.zip', '-AssetOptions', '[[.* asset3.zip * "asset for testing" c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]'])
- 使用 Jython 字符串:
AdminTask.editAsset('-assetID defaultapp.ear -AssetOptions [[.* defaultapp.ear .* "asset for testing" "" "" "" "" false]]')
- 使用 Jython 列表:
AdminTask.editAsset(['-assetID', 'defaultapp.ear', '-AssetOptions', '[[.* defaultapp.ear .* "asset for testing" "" "" "" "" false]]'])
交互方式示例用法
- 使用 Jython:
AdminTask.editAsset('-interactive')
exportAsset
exportAsset 命令会将资产配置导出到文件。
目标对象
无
必需参数
- -assetID
- 指定要导出的资产的配置标识。 只要不完整的配置标识与唯一资产相匹配,此参数就可以接受不完整的配置标识。 (字符串,必需)
- -filename
- 指定系统会将资产配置导出到的文件的名称。 (DownloadFile,必需)
返回值
此命令不会返回输出。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.exportAsset('-assetID asset2.zip -filename c:/temp/a2.zip')
- 使用 Jython 列表:
AdminTask.exportAsset(['-assetID', 'asset2.zip', '-filename', 'c:/temp/a2.zip'])
交互方式示例用法
- 使用 Jython:
AdminTask.exportAsset('-interactive')
importAsset
importAsset 命令会将资产配置导入到资产存储库。 在导入资产之后,您可以将这些资产作为组合单元添加到业务级应用程序。
目标对象
无
必需参数
- -source
- 指定要导入的源文件的名称。 (UploadFile,必需)
可选参数
- -storageType
- 指定系统将资产保存在资产存储库中的方式。 缺省资产存储库会存储完整二进制文件、二进制文件的元数据或不存储二进制文件。 指定
FULL
以存储完整二进制文件。 指定METADATA
以存储二进制文件的元数据部分。 指定NONE
以便不将任何二进制文件存储在资产存储库中。 缺省值为FULL
。 (字符串,可选)
可选步骤
.*
字符来指定只读自变量。 使用 ""
字符指定空字符串,以保留自变量的现有值。 如果没有为可写参数指定值或空字符串,那么该命令会将该参数重置为空值。- -AssetOptions
- 使用 AssetOptions 步骤和以下参数来设置资产的其他属性。
- inputAsset(只读)
- 指定资产的源程序包。
- 名称
- 指定资产的名称。 资产的文件扩展名必须与源程序包的文件扩展名相匹配。 此参数的缺省值为源程序包的文件名。
- defaultBindingProps(只读)
- 指定资产的缺省绑定属性。 此参数仅适用于企业资产。 对于不是企业资产的资产,请指定星号字符 (*) 以进行模式匹配。 对于企业资产,请指定
.*
值以将此参数设置为非空值。 - 描述
- 指定资产的描述。
- destinationUrl
- 指定要部署的资产二进制文件的 URL。
- typeAspect
- 指定资产类型侧重面。 以对象名格式指定 typeAspect 选项,如以下语法所示:
spec=xxx
- 关系
- 指定资产关系。 使用加号字符 (+) 来指定多种资产关系。 如果在关系中指定的资产不存在,那么此命令会返回异常。
- filePermission
- 指定文件许可权配置。
OSGi 应用程序不使用 filePermission 值。
- validate
- 指定是否要验证资产。 缺省值为
false
。 产品没有保存针对 validate 指定的值。 因此,如果选择现在验证资产 (true
) 并稍后编辑该资产,那么在您编辑该资产时,必须再次启用此设置,才能让产品验证所更新的文件。OSGi 应用程序不使用验证值。
返回值
WebSphere:assetname=asset2.zip
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.importAsset('-source c:\ears\asset1.zip -storageType NONE')
- 使用 Jython 列表:
AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'NONE'])
asset2.zip
设置为资产名称,将元数据二进制文件保存在资产存储库中,然后设置要部署的二进制文件的目标目录:- 使用 Jython 字符串:
AdminTask.importAsset('-source c:\ears\asset1.zip -storageType METADATA -AssetOptions [[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
- 使用 Jython 列表:
AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'METADATA', '-AssetOptions', '[[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
a.jar
和 b.jar
资产的资产关系:- 使用 Jython 字符串:
AdminTask.importAsset('[-source c:\ears\asset3.zip -storageType FULL -AssetOptions [[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]]')
- 使用 Jython 列表:
AdminTask.importAsset(['-source', 'c:\ears\asset3.zip', '-storageType', 'FULL', '-AssetOptions', '[[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]'])
- 使用 Jython 字符串:
AdminTask.importAsset('-source c:\ears\defaultapplication.ear -storageType FULL -AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" false]]')
- 使用 Jython 列表:
AdminTask.importAsset(['-source', 'c:\ears\defaultapplication.ear', '-storageType', 'FULL', '-AssetOptions', '[[.* defaultapp.ear .* "desc" "" "" "" false]]'])
交互方式示例用法
- 使用 Jython:
AdminTask.importAsset('-interactive')
listAssets
listAssets 命令会显示单元中每项资产的配置标识。
目标对象
无
可选参数
- -assetID
- 指定相关资产的配置标识。 只要不完整的配置标识与唯一资产相匹配,此参数就可以接受不完整的配置标识。 (字符串,可选)
- -includeDescription
- 指定是否要包括此命令所返回的每项资产的描述。 指定
true
以显示资产描述。 (字符串,可选) - -includeDeplUnit
- 指定是否要显示此命令所返回的每项资产的可部署单元。 指定
true
以显示可部署单元。 (字符串,可选)
返回值
WebSphere:assetname=asset1.zip
"asset for testing"
WebSphere:assetname=asset2.zip
"second asset for testing"
a.jar
WebSphere:aasetname=asset3.zip
"third asset for testing"
a1.jar+a2.jar
WebSphere:assetname=a.jar0
"a.jar for sharedlib"
WebSphere:assetname=b.jar
"b.jar for sharedlib"
WebSphere:assetname=defaultapp.ear
"default app"
批处理方式示例用法
- 使用 Jython:
AdminTask.listAssets()
- 使用 Jython 字符串:
AdminTask.listAssets('-assetID asset1.zip')
- 使用 Jython 列表:
AdminTask.listAssets(['-assetID asset1.zip'])
- 使用 Jython 字符串:
AdminTask.listAssets('-includeDescription true -includeDeplUnit true')
- 使用 Jython 列表:
AdminTask.listAssets(['-includeDescription', 'true', '-includeDeplUnit', 'true')
交互方式示例用法
- 使用 Jython:
AdminTask.listAssets('-interactive')
updateAsset
updateAsset 命令会修改资产的一个或多个文件或模块文件。 此命令会更新资产二进制文件,但不会更新系统将其与资产一起部署来作为备份对象的组合单元。
目标对象
无
必需参数
- -assetID
- 指定要更新的资产的配置标识。 只要不完整的配置标识与唯一资产相匹配,此参数就可以接受不完整的配置标识。 (字符串,必需)
- -operation
- 指定要对相关资产进行调用的操作。 (字符串,必需)
- -contents
- 指定包含要添加或更新的内容的文件。
delete
操作不需要此参数。 (UploadFile,可选)
可选参数
- -contenturi
- 指定要在资产中添加、更新或移除的文件的统一资源标识 (URI)。
merge
或replace
操作不需要此参数。 (字符串,可选)
可选步骤
.*
字符来指定只读自变量。 使用 ""
字符指定空字符串,以保留自变量的现有值。 如果没有为可写参数指定值或空字符串,那么该命令会将该参数重置为空值。- -AssetOptions
- 使用 AssetOptions 步骤和以下参数来设置资产的其他属性。
- name(只读)
- 指定资产的名称。 此参数的缺省值为源程序包的文件名。
- defaultBindingProps(只读)
- 指定资产的缺省绑定属性。 此参数仅适用于企业资产。 对于不是企业资产的资产,请指定星号字符 (*) 以进行模式匹配。 对于企业资产,请指定
.*
值以将此参数设置为非空值。 - 描述
- 指定资产的描述。
- destinationUrl
- 指定要部署的资产二进制文件的 URL。
- typeAspect
- 指定资产类型侧重面。
- 关系
- 指定资产关系。 使用加号字符 (+) 将其他资产添加到现有关系。 使用编号符号字符 (#) 从关系中删除现有资产。 要替换现有关系,请指定 importAsset 命令中所指定的相同语法。 如果关系中指定的资产不存在用于添加或更新,那么该命令将返回异常。
- filePermission
- 指定文件许可权配置。
- validate
- 指定是否要验证资产。 缺省值为
false
。 产品没有保存针对 validate 指定的值。 因此,如果选择现在验证资产 (true
) 并稍后编辑该资产,那么在您编辑该资产时,必须再次启用此设置,才能让产品验证所更新的文件。 - updateAssociatedCUs
- 指定是否更新与企业 (Java EE) 资产相关联的组合单元。 此参数只适用于企业资产。 缺省值为
none
。 指定all
以更新与企业资产关联的所有组合单元。对于
replace
操作,请对 AssetOptions 名称、defaultBindingProps、description、destinationUrl、typeAspect、relationship、filePermission、validate 以及 updateAssociatedCUs 参数指定值。 对于除replace
以外的操作,请对 AssetOptions 名称和 updateAssociatedCU 参数指定值。
返回值
此命令会返回相关资产的配置标识。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.updateAsset('-assetID asset1.zip -operation replace -contents c:/temp/a.zip')
- 使用 Jython 列表:
AdminTask.updateAsset(['-assetID', 'asset1.zip', '-operation', 'replace', '-contents', 'c:/temp/a.zip'])
- 使用 Jython 字符串:
AdminTask.updateAsset('-assetID asset1.zip -operation merge -contents c:/temp/p.zip')
- 使用 Jython 列表:
AdminTask.updateAsset(['-assetID', 'asset1.zip', '-operation', 'merge', '-contents', 'c:/temp/p.zip'])
- 使用 Jython 字符串:
AdminTask.updateAsset('-assetID defaultapp.ear -operation add -contents c:/temp/filename.jar -contenturi filename.jar')
- 使用 Jython 列表:
AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '-operation', 'add', '-contents', 'c:/temp/filename.jar', '-contenturi', 'filename.jar'])
- 使用 Jython 字符串:
AdminTask.updateAsset('-assetID defaultapp.ear -operation replace -contents c:/temp/newapp.ear -AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]')
- 使用 Jython 列表:
AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '-operation', 'replace', '-contents', 'c:/temp/newapp.ear', '-AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]'])
- 使用 Jython 字符串:
AdminTask.updateAsset('-assetID defaultapp.ear -operation merge -contents c:/temp/newapp.ear -AssetOptions [[defaultapp.ear all]]')
- 使用 Jython 列表:
AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '-operation', 'merge', '-contents', 'c:/temp/newapp.ear', '-AssetOptions [[defaultapp.ear all]]'])
交互方式示例用法
- 使用 Jython:
AdminTask.updateAsset('-interactive')
viewAsset
viewAsset 命令会显示其他资产配置选项及所配置的值。
目标对象
无
必需参数
- -assetID
- 指定相关资产的配置标识。 只要不完整的配置标识与唯一资产相匹配,此参数就可以接受不完整的配置标识。 (字符串,必需)
可选参数
无
返回值
Specify Asset options (AssetOptions)
Specify options for Asset.
*Asset Name (name): [defaultapp.ear]
Default Binding Properties (defaultBindingProps):
[defaultbinding.ejbjndi.prefix#defaultbinding.datasource.jndi#defaultbinding.datasource.username
#defaultbinding.datasource.password#defaultbinding.cf.jndi
#defaultbinding.cf.resauth#defaultbinding.virtual.host#defaultbinding.force]
Asset Description (description): []
Asset Binaries Destination Url (destination): [${USER_INSTALL_ROOT}/installedAssets/defaultapp.ear/BASE/defaultapp.ear]
Asset Type Aspects (typeAspect): [WebSphere:spec=j2ee_ear]
Asset Relationships (relationship): []File Permission (filePermission): [.*\\.dll=755#.*\\.so=755#.*\\.a=755#.*\\.sl=755]
Validate asset (validate): [false]
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.viewAsset('-assetID asset3.zip')
- 使用 Jython 列表:
AdminTask.viewAsset(['-assetID', 'asset3.zip'])
交互方式示例用法
- 使用 Jython:
AdminTask.viewAsset('-interactive')
addCompUnit
addCompUnit 命令会将组合单元添加到特定的业务级应用程序。 组合单元表示业务级应用程序中的资产,并使资产内容能够与应用程序中的其他资产进行交互。 它还使产品运行时能够装入和运行资产内容。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,必需)
- -cuSourceID
- 指定要添加的组合单元的源配置标识。 您可以指定资产标识或业务级应用程序标识。 (字符串,必需)
可选参数
- -deplUnits
- 指定要针对资产进行部署的可部署单元。 您可以指定可部署单元子集或所有可部署单元,或将缺省可部署单元用作共享库。 如果未指定此参数,那么系统会部署每个可部署单元。 (字符串,可选)
- -cuConfigStrategyFile
- 指定定制缺省绑定属性的标准文件路径。 此参数只适用于企业资产。 (字符串,可选)
- -defaultBindingOptions
- 指定企业资产的可选 Java 命名和目录接口 (JNDI) 绑定属性。 绑定属性是否可用,依赖于企业资产的类型。 使用格式
property=value
来指定缺省绑定属性。 要指定多个属性,请使用定界符#
分隔每个property=value
语句。 - -JeeImplementation
- 使 SCA 组合体中的服务组件体系结构 (SCA) 组件与企业归档 (EAR) 资产相关联。 SCA 组合定义可以将 Java EE 应用程序定义为组件实现。 您可以在 SCA 组件中
implementation.jee
标记的archive
属性上定义 EAR 资产,并将从资产部署的应用程序用作其实现。 使用 -JeeImplementation 参数将业务级应用程序中的 SCA 组件,与组合体定义中所指定的 EAR 文件相关联。 如果业务级应用程序中只有一个已部署的 EAR 组合单元,并且这个已部署的 EAR 组合单元与组合定义中指定的 EAR 文件匹配,那么不需要指定此参数。- componentName
- 指定您要部署的 SCA 组合中 SCA 组件的名称。 该组件使用 EAR 文件。
- archiveName
- 指定 SCA 组件所使用 EAR 资产的名称。 EAR 文件必须是业务级应用程序的资产。 EAR 资产名称必须与 SCA 组合定义中
implementation.jee
标记上的archive
属性相匹配。 - applicationName
- 指定 EAR 资产的组合单元名称。 要将 SCA 组件与 EAR 文件相关联,EAR 文件必须是 SCA 业务级应用程序的组合单元。
可选步骤
.*
字符来指定只读自变量。 使用 ""
字符指定空字符串,以保留自变量的现有值。 如果没有为可写参数指定值或空字符串,那么该命令会将该参数重置为空值。- -CUOptions
- 指定组合单元的其他属性。 对 CUOptions 步骤指定以下选项:
- parentBLA(只读)
- 指定新组合单元的父业务级应用程序。
- backingID(只读)
- 指定组合单元源标识。
- 名称
- 指定组合单元的名称。
- 描述
- 指定组合单元的描述。
- startingWeight
- 指定组合单元的启动权重。 支持的值介于 1 到 2147483647(最大整数值)之间。
- startedOnDistributed
- 指定是否要在将更改分布到目标节点之后启动组合单元。 缺省值为
false
。 - restartBehaviorOnUpdate
- 指定要在编辑组合单元之后重新启动的节点。 指定
ALL
以重新启动每个目标节点。 指定DEFAULT
以重新启动同步插件所控制的节点。 指定NONE
以阻止系统重新启动节点。
- -MapTargets
- 指定组合单元目标映射的其他属性。 对 MapTargets 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- 台服务器
- 指定目标以部署组合单元。 缺省值为
server1
服务器。 使用加号字符 (+) 来指定多个目标。 将加号字符 (+) 用作前缀来添加其他目标。 指定不是WebSphere Application Server 服务器的每个服务器的完整对象名格式。
- -ActivationPlanOptions
- 指定组合单元激活计划的其他属性。 对 ActivationPlanOptions 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- activationPlan
- 将运行时组件列表指定为激活计划。 使用格式
specName=xxx,specVersion=yyy
指定每个激活计划,其中specName
表示规范的名称,且必须指定。 使用加号字符 (+) 来指定多个激活计划。
- -CreateAuxCUOptions
- 指定辅助组合单元的其他属性。 如果组合单元源是一项资产,此资产所对应的资产在业务级应用程序中没有匹配的组合单元,请使用此步骤。 对 CreateAuxCUOptions 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- inputAsset(只读)
- 指定组合单元源标识。
- cuID
- 指定系统针对资产创建的组合单元标识。 如果不想创建新组合单元,请不要指定此参数。
- matchTarget
- 指定是否要使依赖性辅助组合单元的目标,与新组合单元的目标相匹配。 缺省值为
true
。
- -RelationshipOptions
- 指定资产、组合单元及业务级应用程序之间的关系的其他属性。 如果组合单元的源标识是一项资产,此资产在业务级应用程序中具有匹配的组合单元,请使用此步骤。 对 RelationshipOptions 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- 关系
- 定义组合单元关系。 使用格式
cuName=xxx
指定组合单元对象名。 在关系中使用加号字符 (+) 来指定多个组合单元对象名。 如果在关系中指定的组合单元不在同一业务级应用程序下,那么系统会返回错误。 - matchTarget
- 指定是否要使组合单元关系的目标,与新组合单元的目标相匹配。 缺省值为
true
。
- -ContextRootStep
- 对于 EBA 资产,上下文根确定运行时在何处查找特定 Web 应用程序包 (WAB) 的 Web 页面。
- -VirtualHostMappingStep
- 对于 EBA 资产,可以使用虚拟主机使唯一端口与模块或应用程序相关联。 虚拟主机的别名标识了为该虚拟主机定义的端口号。 在用来访问
Web 模块工件(例如 Servlet 和 JavaServer Page (JSP) 文件)的 URL 中,将使用虚拟主机别名中指定的端口号。 例如,别名
myhost:8080
是 URLhttp://myhost:8080/sample
的 host_name:port_number 部分。 - -MapRolesToUsersStep
- 对于 EBA 资产,请使用此步骤将安全角色映射到用户或组。
- -BlueprintResourceRefBindingStep
- 对于 EBA 资产, Blueprint 组件可以访问 WebSphere Application Server 资源引用。 每个引用都在 "蓝图" XML 文件中声明,并且可以使用 Java Platform, Enterprise Edition (Java EE) 连接器体系结构 (JCA) 认证别名进行保护。 OSGi 应用程序中的每个捆绑软件可以在其各个“蓝图”XML 文件中包含任意数量的资源引用声明。
- -WebModuleMsgDestRefs
- 对于 EBA 资产,绑定资源引用会将 Web 应用程序的资源依赖关系映射到服务器运行时环境中的实际可用资源。 至少,可以通过使用一个指定了 JNDI 名称(用于在运行时环境中标识该资源)的映射来实现此目标。 缺省情况下,JNDI 名称是开发 Web 应用程序包 (WAB) 期间在 web.xml 文件中指定的资源标识。 使用此选项来绑定类型为 message-destination-ref (消息目标引用) 或 resource-env-ref (资源环境引用) 的资源,如 Java 规范 JSR-250: Java 平台的公共注释。
- -WebModuleResourceRefs
- 对于 EBA 资产,绑定资源引用会将 Web 应用程序的资源依赖关系映射到服务器运行时环境中的实际可用资源。 至少,可以通过使用一个指定了 JNDI 名称(用于在运行时环境中标识该资源)的映射来实现此目标。 缺省情况下,JNDI 名称是开发 Web 应用程序包 (WAB) 期间在 web.xml 文件中指定的资源标识。 使用此选项来绑定类型为 resource-ref (资源引用) 的资源,如 Java 规范 JSR-250: Java Platform 的公共注释中所定义。
返回值
WebSphere:cuname=cu4
WebSphere:cuname=cua
WebSphere:cuname=cud
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID myBLA -cuSourceID assetname=asset1.zip -CUOptions [[.* .* cu1 "cu1 desc1" 0 false DEFAULT]] -MapTargets [[.* server1]] -ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'myBLA', '-cuSourceID', 'assetname=asset1.zip', '-CUOptions', '[[.* .* cu1 "cu1 desc1" 0 false DEFAULT]]', '-MapTargets', '[[.* server1]]', '-ActivationPlanOptions', '[.* specname=actplan0+specname=actplan1]'])
- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID myBLA -cuSourceID yourBLA -CUOptions [[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'myBLA', '-cuSourceID', 'yourBLA', '-CUOptions', '[[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]'])
implementation.jee
标记的 archive
属性上定义 EAR 资产的每个 SCA 组件,请指定一行,其中包含 componentName、archiveName 以及 applicationName 的值。 以下示例会将一个 SCA 组件与一个 EAR 资产组合单元相关联:- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID myBLA -cuSourceID yourBLA -JeeImplementation [[mySCAcomponent myEARfile myEARassetName]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'myBLA', '-cuSourceID', 'yourBLA', 'JeeImplementation', '[[mySCAcomponent myEARfile myEARassetName]]'])
AdminTask.addCompUnit('[
-blaID WebSphere:blaname=helloWorldService
-cuSourceID WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
-CUOptions [
[WebSphere:blaname=helloWorldService.eba
WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
com.ibm.ws.eba.helloWorldService_0001.eba "" 1 false DEFAULT]]
-MapTargets [[ebaDeploymentUnit WebSphere:node=node01,server=server1]]
-ActivationPlanOptions [[default ""]]
-ContextRootStep [
[com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"]
[com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
-VirtualHostMappingStep [
[com.ibm.ws.eba.helloWorldService.web 1.0.0
"HelloWorld service" default_host]
[com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0
"HelloWorld second service" test_host]]
-MapRolesToUsersStep [
[ROLE1 No Yes "" ""]
[ROLE2 No No WABTestUser1 ""]
[ROLE3 No No "" WABTestGroup1]
[ROLE4 Yes No "" ""]]
-BlueprintResourceRefBindingStep[
[com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
javax.sql.DataSource jdbc/Account Container Shareable alias1]]
-WebModuleMsgDestRefs [
[com.ibm.ws.eba.helloWorldService.web 1.0.0
jms/myQ javax.jms.Queue jms/workQ]
[com.ibm.ws.eba.helloWorldService.web 1.0.0
jms/myT javax.jms.Topic jms/notificationTopic]]
-WebModuleResourceRefs [
[com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
jdbc/helloDs "" "" ""]
[com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
]')
- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID theirBLA -cuSourceID asset2.zip -CUOptions [[.* .* cu2 "cu2 desc" 0 false DEFAULT]] -MapTargets [[.* server1+server2]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'theirBLA', '-cuSourceID', 'asset2.zip', '-CUOptions', '[[.* .* cu2 "cu2 desc" 0 false DEFAULT]]', '-MapTargets', '[[.* server1+server2]]'])
- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID yourBLA -cuSourceID asset2.zip -deplUnits a.jar -CUOptions [[.* .* cu3 "cu3 desc" 0 false DEFAULT]] -MapTargets [[a.jar server1]] -ActivationPlanOptions [[a.jar specname=actplan1]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'yourBLA', '-cuSourceID', 'asset2.zip', '-deplUnits', 'a.jar', '-CUOptions', '[[.* .* cu3 "cu3 desc" 0 false DEFAULT]]', '-MapTargets', '[[a.jar server1]]', '-ActivationPlanOptions', '[[a.jar specname=actplan1]]'])
- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID ourBLA -cuSourceID b.jar -deplUnits default -CUOptions [[.* .* cub "cub desc" 0 false DEFAULT]] -MapTargets [[default server1]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'ourBLA', '-cuSourceID', 'b.jar', '-deplUnits', 'default', '-CUOptions', '[[.* .* cub "cub desc" 0 false DEFAULT]]', '-MapTargets', '[[default server1]]'])
cub
组合单元是作为 ourBLA
业务级应用程序的共享库而存在:- 使用 Jython 字符串:
AdminTask.addCompUnit('-blaID ourBLA -cuSourceID asset3.zip -deplUnits a1.jar -CUOptions [[.* .* cu4 "cu4 desc" 0 false DEFAULT]] -MapTargets [[a1.jar cluster1+cluster2]] -CreateAuxCUOptions [[a1.jar a.jar cua true]] -RelationshipOptions [[a1.jar cuname=cub true]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'ourBLA', '-cuSourceID', 'asset3.zip', '-deplUnits', 'a1.jar', '-CUOptions', '[[.* .* cu4 "cu4 desc" 0 false DEFAULT]]', '-MapTargets', '[[a1.jar cluster1+cluster2]]', '-CreateAuxCUOptions', '[[a1.jar a.jar cua true]]', '-RelationshipOptions', '[[a1.jar cuname=cub true]]'])
- 使用 Jython 字符串:
AdminTask.addCompUnit('[-blaID yourBLA -cuSourceID defaultapp.ear -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=server2]] -CtxRootForWebMod [[defaultapp.war .* myctx/]]]')
- 使用 Jython 列表:
AdminTask.addCompUnit(['-blaID', 'yourBLA', '-cuSourceID', 'defaultapp.ear', '-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=server2]]', '-CtxRootForWebMod', '[[defaultapp.war .* myctx/]]'])
交互方式示例用法
- 使用 Jython:
AdminTask.addCompUnit('-interactive')
deleteCompUnit
deleteCompUnit 命令会移除组合单元。 只要系统可以将不完整的配置标识与唯一标识相匹配,此命令的两个参数就可以接受不完整的配置标识。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,必需)
- -cuID
- 指定要删除的组合单元的配置标识。 (字符串,必需)
可选参数
- -force
- 指定即使其他组合单元依赖于此组合单元,是否仍要强制系统删除此组合单元。 (布尔值,可选)
返回值
WebSphere:cuname=cu1
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.deleteCompUnit('-blaID myBLA -cuID cu1 -force
true
') - 使用 Jython 列表:
AdminTask.deleteCompUnit(['-blaID', 'myBLA', '-cuID', 'cu1', '-force', '
true
'])
交互方式示例用法
- 使用 Jython:
AdminTask.deleteCompUnit('-interactive')
editCompUnit
editCompUnit 命令会修改其他组合单元选项。 您可以使用此命令来修改组合单元的启动权重、部署目标、激活计划选项以及关系设置。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,必需)
- -cuID
- 指定要编辑的组合单元的配置标识。 (字符串,必需)
可选步骤
.*
字符来指定只读自变量。 使用 ""
字符指定空字符串,以保留自变量的现有值。 如果没有为可写参数指定值或空字符串,那么该命令会将该参数重置为空值。- -CUOptions
- 指定组合单元的其他属性。 对 CUOptions 步骤指定以下选项:
- parentBLA(只读)
- 指定组合单元的父业务级应用程序。
- backingID(只读)
- 指定组合单元源标识。
- name(只读)
- 指定组合单元的名称。
- 描述
- 指定组合单元的描述。
- startingWeight
- 指定组合单元的启动权重。 支持的值介于 1 到 2147483647(最大整数值)之间。
- startedOnDistributed
- 指定是否要在将更改分布到目标节点之后启动组合单元。 缺省值为
false
。 - restartBehaviorOnUpdate
- 指定要在编辑组合单元之后重新启动的节点。 指定
ALL
以重新启动每个目标节点。 指定DEFAULT
以重新启动同步插件所控制的节点。 指定NONE
以阻止系统重新启动节点。
- -MapTargets
- 指定组合单元目标映射的其他属性。 对 MapTargets 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- 台服务器
- 指定目标以部署组合单元。 缺省值为
server1
服务器。 使用加号字符 (+) 来指定多个目标。 将加号字符 (+) 用作前缀来添加其他目标。 指定不是 WebSphere Application Server 服务器的每个服务器的完整对象名格式。
- -ActivationPlanOptions
- 指定组合单元激活计划的其他属性。 对 ActivationPlanOptions 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- activationPlan
- 将运行时组件列表指定为激活计划。 使用格式
specName=xxx,specVersion=yyy
指定每个激活计划,其中specName
表示规范的名称,且必须指定。 使用加号字符 (+) 来指定多个激活计划。
- -RelationshipOptions
- 指定资产、组合单元及业务级应用程序之间的关系的其他属性。 如果组合单元的源标识是一项资产,此资产在业务级应用程序中具有匹配的组合单元,请使用此步骤。 对 RelationshipOptions 步骤指定以下选项:
- deplUnit(只读)
- 指定可部署单元统一资源标识 (URI)。
- 关系
- 定义组合单元关系。 使用格式
cuName=xxx
指定组合单元对象名。 在关系中使用加号字符 (+) 来指定多个组合单元对象名。 如果在关系中指定的组合单元不在同一业务级应用程序下,那么系统会返回错误。 - matchTarget
- 指定是否要使组合单元关系的目标,与新组合单元的目标相匹配。 缺省值为
true
。
- -ReferenceJMSBindingResources
- 指定业务级应用程序的服务组件体系结构 (SCA) 组合的 Java 消息服务 (JMS) 绑定的资源引用元素的 JNDI 设置。 要运行 editCompUnit 命令,请指定必需参数和此可选步骤。 您可以编辑目标 JNDI 名称或连接工厂 JNDI 名称。 此命令会更新 JMS 绑定中所定义的资源。 JMS 资源必须已存在。 在您编辑组合单元时,产品不会动态创建 JMS 资源。
- -ServiceJMSBindingResources
- 为业务级应用程序的服务组件体系结构 (SCA) 组合的 Java 消息服务 (JMS) 绑定的资源服务元素指定可编辑的 JNDI 设置。 要运行 editCompUnit 命令,请指定必需参数和此可选步骤。 您可以编辑目标 JNDI 名称或激活规范 JNDI 名称。 此命令会更新 JMS 绑定中所定义的资源。 JMS 资源必须已存在。 在您编辑组合单元时,产品不会动态创建 JMS 资源。
- -ReferenceJMSBindingResponseResources
- 为业务级应用程序的服务组件体系结构 (SCA) 组合的 Java 消息服务 (JMS) 绑定的响应资源引用元素指定可编辑的 JNDI 设置。 要运行 editCompUnit 命令,请指定必需参数和此可选步骤。 您可以编辑响应目标 JNDI 名称或响应连接工厂 JNDI 名称。 此命令会更新 JMS 绑定中所定义的响应资源。 JMS 资源必须已存在。 在您编辑组合单元时,产品不会动态创建 JMS 资源。
- -ServiceJMSBindingResponseResources
- 指定业务级应用程序的服务组件体系结构 (SCA) 组合的 Java 消息服务 (JMS) 绑定的响应资源服务元素的 JNDI 设置。 要运行 editCompUnit 命令,请指定必需参数和此可选步骤。 您可以编辑响应目标 JNDI 名称或响应连接工厂 JNDI 名称。 此命令会更新 JMS 绑定中所定义的响应资源。 JMS 资源必须已存在。 在您编辑组合单元时,产品不会动态创建 JMS 资源。
- -ContextRootStep
- 对于 EBA 资产,上下文根确定运行时在何处查找特定 Web 应用程序包 (WAB) 的 Web 页面。
- -VirtualHostMappingStep
- 对于 EBA 资产,可以使用虚拟主机使唯一端口与模块或应用程序相关联。 虚拟主机的别名标识了为该虚拟主机定义的端口号。 在用来访问
Web 模块工件(例如 Servlet 和 JavaServer Page (JSP) 文件)的 URL 中,将使用虚拟主机别名中指定的端口号。 例如,别名
myhost:8080
是 URLhttp://myhost:8080/sample
的 host_name:port_number 部分。 - -MapRolesToUsersStep
- 对于 EBA 资产,请使用此步骤将安全角色映射到用户或组。
- -BlueprintResourceRefPostDeployStep
- 对于 EBA 资产, Blueprint 组件可以访问 WebSphere Application Server 资源引用。 每个引用都在 "蓝图" XML 文件中声明,并且可以使用 Java Platform, Enterprise Edition (Java EE) 连接器体系结构 (JCA) 认证别名进行保护。 OSGi 应用程序中的每个捆绑软件可以在其各个“蓝图”XML 文件中包含任意数量的资源引用声明。
- -WebModuleResourceRefs
- 对于 EBA 资产,绑定资源引用会将 Web 模块的资源依赖关系映射到服务器运行时环境中的实际可用资源。 至少,可以通过使用一个指定了 JNDI 名称(用于在运行时环境中标识该资源)的映射来实现此目标。 缺省情况下,JNDI 名称是开发 Web 应用程序包 (WAB) 期间在 web.xml 文件中指定的资源标识。
返回值
此命令会返回系统所编辑组合单元的配置标识。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.editCompUnit('-blaID myBLA -cuID cu1 -CUOptions [[.* .* cu1 cudesc 1 false DEFAULT]] -MapTargets [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
- 使用 Jython 列表:
AdminTask.editCompUnit(['-blaID', 'myBLA', '-cuID', 'cu1', '-CUOptions', '[[.* .* cu1 cudesc 1 false DEFAULT]]', '-MapTargets', ' [[.* server2]]', '-ActivationPlanOptions', '[.* #specname=actplan0+specname=actplan2]'])
- 使用 Jython 字符串:
AdminTask.editCompUnit('-blaID ourBLA -cuID cu4 -CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]] -MapTargets [[a1.jar server1+server2]] -RelationshipOptions [[a1.jar cuname=cub true]]')
- 使用 Jython 列表:
AdminTask.editCompUnit(['-blaID', 'ourBLA', '-cuID', 'cu4', '-CUOptions', ' [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '-MapTargets', '[[a1.jar server1+server2]]', '-RelationshipOptions', '[[a1.jar cuname=cub true]]'])
- 使用 Jython 字符串:
AdminTask.editCompUnit('[-blaID ourBLA -cuID cu4 -CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]] -MapTargets [[a1.jar server1+server2]] -RelationshipOptions [[a1.jar +cuname=cuc true]] -ActivationPlanOptions [a1.jar +specname=actplan2#specname=actplan1]]')
- 使用 Jython 列表:
AdminTask.editCompUnit(['-blaID', 'ourBLA', '-cuID', 'cu4', '-CUOptions', ' [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '-MapTargets', '[[a1.jar server1+server2]]', '-RelationshipOptions', '[[a1.jar +cuname=cuc true]]', '-ActivationPlanOptions', '[a1.jar +specname=actplan2#specname=actplan1]'])
- 使用 Jython 字符串:
AdminTask.editCompUnit('-blaID yourBLA -cuID defaultapp -MapModulesToServers [[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]] -CtxRootForWebMod [[defaultapp.war .* /]] -MapWebModToVH [[defaultapp.war .* vh1]]')
- 使用 Jython 列表:
AdminTask.editCompUnit(['-blaID', 'yourBLA', '-cuID', 'defaultapp', '-MapModulesToServers', '[[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]]', '-CtxRootForWebMod', '[[defaultapp.war .* /]]', '-MapWebModToVH', '[[defaultapp.war .* vh1]]'])
交互方式示例用法
- 使用 Jython:
AdminTask.editCompUnit('-interactive')
listCompUnits
listCompUnits 命令会显示每个与特定业务级应用程序相关联的组合单元。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,必需)
可选参数
- -includeDescription
- 指定是否要包括此命令所返回的每项资产的描述。 (字符串,可选)
- -includeType
- 指定是否要包括此命令所返回的每项资产的类型。 (字符串,可选)
返回值
Websphere:cuname=cu1
asset
"description for cu1"
Websphere:cuname=cu4
bla
"description for cu4"
WebSphere:cuname=defaultapp
Java EE
"description for defaultapp"
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.listCompUnits('-blaID blaname=theirBLA')
- 使用 Jython 列表:
AdminTask.listCompUnits(['-blaID', 'blaname=theirBLA'])
交互方式示例用法
- 使用 Jython:
AdminTask.listCompUnits('-interactive')
setCompUnitTargetAutoStart
setCompUnitTargetAutoStart 命令会启用或禁止组合单元的自动启动。 如果您启用此选项,那么在启动组合单元目标时,系统会自动启动组合单元。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 如果系统可以将不完整的配置标识与唯一业务级应用程序标识相匹配,那么此命令可以接受不完整的配置标识。 (字符串,必需)
- -cuID
- 指定相关组合单元。 如果系统可以将不完整的配置标识与唯一组合单元标识相匹配,那么此命令可以接受不完整的配置标识。 (字符串,必需)
- -targetID
- 指定相关目标的名称。 例如,指定服务器名称以将目标设置为特定服务器。 (字符串,必需)
- -enable
- 指定在启动所指定的目标时,是否要自动启动相关组合单元。 指定
true
以自动启动组合单元。 如果未指定true
,那么在启动目标时,系统将不会启动组合单元。 缺省值为true
。 (字符串,必需)
返回值
此命令不会返回输出。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.setCompUnitTargetAutoStart('-blaID bla1 -cuID cu1 -targetID server1 -enable true')
- 使用 Jython 列表:
AdminTask.setCompUnitTargetAutoStart(['-blaID', 'bla1', '-cuID', 'cu1', '-targetID', 'server1', '-enable', 'true'])
交互方式示例用法
- 使用 Jython 字符串:
AdminTask.setCompUnitTargetAutoStart('-interactive')
viewCompUnit
viewCompUnit 命令会显示属于特定业务级应用程序的组合单元的配置信息。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 如果系统可以将不完整的配置标识与唯一业务级应用程序标识相匹配,那么此参数可以接受不完整的配置标识。 (字符串,必需)
- -cuID
- 指定相关组合单元的配置标识。 如果系统可以将不完整的配置标识与唯一组合单元标识相匹配,那么此参数可以接受不完整的配置标识。 (字符串,必需)
可选参数
无
返回值
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): [cuDesc]
Starting Weight (startingWeight): [0]
Started on distributed (startedOnDistributed): [false]
Restart behavior on update (restartBehaviorOnUpdate): [DEFAULT]
Specify servers (MapTargets)
Specify targets such as application servers or clusters of application servers where you want
to deploy the cu contained in the application.
Deployable Unit (deplUnit): [default]
*Servers (server): [WebSphere:node=myNode,server=server1]
Specify Composition Unit activation plan options (ActivationPlanOptions)
Specify CU activation plan optionsDeployableUnit Name (deplUnit): [default]
Activation Plan (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1]
如果组合单元是使用 Java 消息服务 (JMS) 绑定的服务组件体系结构 (SCA) 组合体,那么 viewCompUnit 命令还会返回有关 JMS 绑定引用或服务的信息。
- 使用最新的 OSGi 应用程序部署。
- 新 OSGi 应用程序部署尚不可用,因为它需要的捆绑软件仍在下载。
- 新的 OSGi 应用程序部署可用。
- 无法应用新 OSGi 应用程序部署,因为捆绑软件下载失败。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.viewCompUnit('-blaID myBLA -cuID myCompUnit')
- 使用 Jython 列表:
AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID', 'myCompUnit'])
- 使用 Jython 字符串:
AdminTask.viewCompUnit('-blaID myBLA -cuID defaultApplication')
- 使用 Jython 列表:
AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID', 'defaultApplication'])
交互方式示例用法
- 使用 Jython:
AdminTask.viewCompUnit('-interactive')
createEmptyBLA
用来创建空业务级应用程序的 createEmptyBLA 命令。 在创建业务级应用程序之后,您可以将资产或其他业务级应用程序作为组合单元添加到应用程序。
目标对象
无
必需参数
- -name
- 指定新业务级应用程序的唯一名称。 (字符串,必需)
可选参数
- -description
- 指定新业务级应用程序的描述。 (字符串,可选)
返回值
WebSphere:blaname=myBLA
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.createEmptyBLA('-name myBLA -description "my description for BLA"')
- 使用 Jython 列表:
AdminTask.createEmptyBLA(['-name', 'myBLA', '-description', '"my description for BLA"'])
交互方式示例用法
- 使用 Jython:
AdminTask.createEmptyBLA('-interactive')
deleteBLA
deleteBLA 命令会从配置中移除业务级应用程序。 在删除业务级应用程序前,请使用 deleteCompUnit 命令来移除每个与该业务级应用程序相关联的组合单元。 另外,验证任何其他业务级应用程序都未引用要删除的企业级应用程序。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 只要系统可以将 blaID 参数的不完整标识与唯一标识相匹配,此命令就可以接受不完整的标识。 例如,您可以指定
myBLA
部分标识,以识别WebSphere:blaname=myBLA
配置标识。 (字符串,必需)
可选参数
无
返回值
WebSphere:blaname=myBLA
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.deleteBLA('-blaID myBLA')
- 使用 Jython 列表:
AdminTask.deleteBLA(['-blaID', 'myBLA'])
交互方式示例用法
- 使用 Jython:
AdminTask.deleteBLA('-interactive')
editBLA
editBLA 命令会修改业务级应用程序的描述。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,必需)
可选步骤
.*
字符来指定只读自变量。 使用 ""
字符指定空字符串,以保留自变量的现有值。 如果没有为可写参数指定值或空字符串,那么该命令会将该参数重置为空值。- -BLAOptions
- 使用 BLAOptions 步骤来指定相关业务级应用程序的新描述。
- name(只读)
- 指定企业级别应用程序的名称。
- 描述
- 指定业务级应用程序的描述。
返回值
此命令不会返回输出。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.editBLA('-blaID DefaultApplication -BLAOptions [[.* "my new description"]]')
- 使用 Jython 列表:
AdminTask.editBLA(['-blaID', 'DefaultApplication', '-BLAOptions', '[[.* "my new description"]]'])
交互方式示例用法
- 使用 Jython:
AdminTask.editBLA('-interactive')
getBLAStatus
getBLAStatus 命令会显示业务级应用程序或组合单元是正在运行还是已停止。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 使用 listBLAs 命令来显示业务级应用程序配置标识的列表。 (字符串,必需)
可选参数
- -cuID
- 指定相关组合单元的配置标识。 使用 listCompUnits 命令来显示组合单元配置标识的列表。 (字符串,可选)
返回值
此命令会返回相关业务级应用程序或组合单元的状态。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.getBLAStatus('-blaID WebSphere:blaname=myBLA -cuID Websphere:cuname=cu1')
- 使用 Jython 列表:
AdminTask.getBLAStatus(['-blaID', 'WebSphere:blaname=myBLA', '-cuID', 'Websphere:cuname=cu1'])
交互方式示例用法
- 使用 Jython:
AdminTask.getBLAStatus('-interactive')
listBLAs
listBLAs 命令会显示配置中的业务级应用程序。
目标对象
无
可选参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,可选)
- -includeDescription
- 指定是否要包括此命令所返回的每个业务级应用程序的描述。 指定
true
以显示业务级应用程序描述。 (字符串,可选)
返回值
WebSphere:blaname=myBLA
WebSphere:blaname=yourBLA
批处理方式示例用法
- 使用 Jython:
AdminTask.listBLAs()
- 使用 Jython 字符串:
AdminTask.listBLAs('-blaID myBLA')
- 使用 Jython 列表:
AdminTask.listBLAs(['-blaID', 'myBLA'])
- 使用 Jython 字符串:
AdminTask.listBLAs('-includeDescription true')
- 使用 Jython 列表:
AdminTask.listBLAs(['-includeDescription', 'true'])
交互方式示例用法
- 使用 Jython 字符串:
AdminTask.listBLAs('-interactive')
listControlOps
listControlOps 命令会显示业务级应用程序的控制操作及相应的组合单元。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 (字符串,必需)
可选参数
- -cuID
- 指定相关组合单元。 (字符串,可选)
- -opName
- 指定相关操作名称。 (字符串,可选)
- -long
- 指定是否要在命令输出中包括其他配置信息。 (字符串,可选)
返回值
"Operation: start"
"Description: Start operation"
"Operation handler ID: com.mycompany.myasset.ControlOpHandler"
"Operation handler data URI: None"
"Operation: stop"
"Description: Stop operation"
"Operation handler ID: com.mycompany.myasset.ControlOpHandler"
"Operation handler data URI: None"
"Operation: clearCache"
"Description: Clears specified cache or all caches"
"Operation handler ID: com.mycompany.myasset.ControlOpHandler"
"Operation handler data URI: None"
"Parameter: cacheName"
"Description: Name of cache to clear. If not specified, all caches are cleared."
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.listControlOps('-blaID myBLA -cuID myservice.jar -long true')
- 使用 Jython 列表:
AdminTask.listControlOps(['-blaID', 'myBLA', '-cuID', 'myservice.jar', '-long true'])
交互方式示例用法
- 使用 Jython:
AdminTask.listControlOps('-interactive')
startBLA
startBLA 命令会启动相关业务级应用程序。
目标对象
无
必需参数
- -blaID
- 指定要启动的业务级应用程序的配置标识。 如果系统可以将不完整的配置标识与配置中的唯一标识相匹配,那么此命令可以接受不完整的配置标识。 (字符串,必需)
返回值
CWWMH0196I: Business-level application "WebSphere:blaname=DefaultApplication" was started successfully.
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.startBLA('-blaID myBLA')
- 使用 Jython 列表:
AdminTask.startBLA(['-blaID', 'myBLA'])
交互方式示例用法
- 使用 Jython:
AdminTask.startBLA('-interactive')
stopBLA
stopBLA 命令会停止相关业务级应用程序。
目标对象
无
必需参数
- -blaID
- 指定要停止的业务级应用程序的配置标识。 如果系统可以将不完整的配置标识与配置中的唯一标识相匹配,那么此命令可以接受不完整的配置标识。 (字符串,必需)
返回值
CWWMH0199I: Business-level application "WebSphere:blaname=myBLA" was stopped successfully.
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.stopBLA('-blaID myBLA')
- 使用 Jython 列表:
AdminTask.stopBLA(['-blaID', 'myBLA'])
交互方式示例用法
- 使用 Jython:
AdminTask.stopBLA('-interactive')
viewBLA
viewBLA 命令会显示相关业务级应用程序的名称和描述。
目标对象
无
必需参数
- -blaID
- 指定相关业务级应用程序的配置标识。 如果系统可以将不完整的配置标识与唯一业务级应用程序相匹配,那么此命令可以接受不完整的配置标识。 (字符串,必需)
可选参数
无
返回值
Specify BLA options (BLAOptions)
Specify options for BLA
*BLA Name (name): [DefaultApplication]
BLA Description (description): []
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.viewBLA('-blaID DefaultApplication')
- 使用 Jython 列表:
AdminTask.viewBLA(['-blaID', 'DefaultApplication'])
交互方式示例用法
- 使用 Jython:
AdminTask.viewBLA('-interactive')