可使用动态集群命令取代管理控制台来查看或编辑动态集群。
使用以下命令可创建动态集群、从集群添加或移除服务器、列示动态集群或修改动态集群。
避免故障: 使用其中任何更改配置的命令之后,请确保使用
AdminConfig.save() 命令保存更改。
gotcha
createDynamicCluster
使用 createDynamicCluster 命令可创建新的动态集群。
必需参数
- -membershipPolicy:指定成员资格策略。(字符串,必需)
可选参数
- -dynamicClusterProperties:指定动态集群属性。(字符串,可选)可指定下列选项:
- operationalMode:指定运作方式。有效值是:manual、supervised 和 automatic。
- minInstances:将最小集群实例数指定为整数。
- serverInactivityTime:指定停止实例前等待的时间(以分钟计)。仅当将 minInstances 参数值设置为 0 时,此值才有效。
- maxInstances:将最大集群实例数指定为整数。如果不想限制可启动的集群实例的数量,请指定 -1。
- numVerticalInstances:指定通过创建垂直实例可在相同节点上启动的实例数。请指定整数值。
- -clusterProperties:指定集群属性。(字符串,可选)可指定下列选项:
- preferLocal:指定是否将企业 Bean 请求路由到其上驻留客户机的节点(如果可能)。有效值是 true 或 false。
- createDomain:指定为此集群创建的复制域。仅可为 WebSphere® Application Server 应用程序服务器创建复制域。有效值是 true 或 false。
- coreGroup:指定动态集群的核心组的名称。只需要指定 WebSphere Application Server 应用程序服务器的核心组。值可以是 DefaultCoreGroup 或核心组名称。
- templateName:指定服务器模板的名称。有效输入包括下列值:
- 对于 WebSphere Application Server 动态集群:缺省值和 cell_name/node_name/was_server_name
不推荐使用的功能部件: 不推荐创建动态集群时使用的
defaultXD 和
defaultXDZOS 服务器模板。请改为使用
default 或
defaultZOS 服务器模板。
depfeat
clusterShortName:对于 z/OS® 平台,请指定集群的短名称。创建动态集群后,可以使用 AdminTask changeClusterShortName 命令更新此字段。
serverSpecificShortNames:对于 z/OS 平台,以逗号分隔的列表格式指定集群成员的特定短名称,例如:SSN1,SSN2。使用逗号分隔多个短名称。如果没有提供供所有制集群成员使用的足够多的短名称,那么会为其余集群成员指定生成的通用短名称,例如,BBOS001, BBOS002 等。创建动态集群后,可以使用 serverSpecificShortNames 定制属性更新此列表。在动态集群上设置此属性。如果在创建动态集群后要使用脚本编制功能更改此属性,那么可以使用 AdminTask changeServerSpecificShortName 命令。
返回值
该命令返回您创建的动态集群的 javax.management.ObjectName 值。
批处理方式示例用法
- 使用 Jacl:
$AdminTask createDynamicCluster dcName {-membershipPolicy node_nodegroup='ngName'}
或
$AdminTask createDynamicCluster dcName {-membershipPolicy "node_nodegroup = 'ngName'" -dynamicClusterProperties
"{operationalMode automatic}{minInstances 0}{maxInstances -1}{numVerticalInstances 1}{serverInactivityTime 1440}"
-clusterProperties "{preferLocal false}{createDomain false}{templateName default}{coreGroup DefaultCoreGroup}
{clusterShortName BBOC001}{serverSpecificShortNames BBOS001,BBOS002}"}
- 使用 Jython 字符串:
AdminTask.createDynamicCluster(dcName,'[-membershipPolicy "node_nodegroup = \'ngName\'" -dynamicClusterProperties
"{{operationalMode automatic}{minInstances 0}{maxInstances -1}{numVerticalInstances 1}{serverInactivityTime 1440}}"
-clusterProperties "{{preferLocal false}{createDomain false}{templateName default}{coreGroup DefaultCoreGroup}
{clusterShortName BBOC001}{serverSpecificShortNames BBOS001,BBOS002}}"]')
或者,如果您在
WebSphere Application Server V7.0 或更高版本上运行:
AdminTask.createDynamicCluster('dcName','[-membershipPolicy "node_nodegroup = \'ngName\'" -dynamicClusterProperties
"[[operationalMode automatic][minInstances 0][maxInstances -1][numVerticalInstances 1][serverInactivityTime 1440]]"
-clusterProperties "[[preferLocal false][createDomain false][templateName default][coreGroup DefaultCoreGroup]
[clusterShortName BBOC001][serverSpecificShortNames BBOS001,BBOS002]]"]')
交互方式示例用法
createPHPDynamicCluster
使用 createPHPDynamicCluster 命令可创建新的 PHP 动态集群。
必需参数
- -membershipPolicy:指定成员资格策略子表达式。(字符串,必需)
可选参数
- -dynamicClusterProperties:指定动态集群属性。(字符串,可选)可指定下列选项:
- operationalMode:指定运作方式。有效值是:manual、supervised 和 automatic。
- minInstances:将最小集群实例数指定为整数。
- serverInactivityTime:指定停止实例前等待的时间(以分钟计)。仅当将 minInstances 参数值设置为 0 时,此值才有效。
- maxInstances:将最大集群实例数指定为整数。如果不想限制可启动的集群实例的数量,请指定 -1。
- numVerticalInstances:指定通过创建垂直实例可在相同节点上启动的实例数。请指定整数值。
- -clusterProperties:指定服务器模板的名称。有效输入包括 templateName 值:
- 对于 PHP 动态集群:APACHE13_PHP4、APACHE13_PHP5、APACHE20_PHP4、APACHE20_PHP5、APACHE22_PHP4、APACHE22_PHP5 和 cellName/nodeName/php_serverName。
返回值
该命令返回您创建的动态集群的 javax.management.ObjectName 值。
批处理方式示例用法
- 使用 Jacl:
$AdminTask createPHPDynamicCluster dcName {-membershipPolicy "node_property$APACHE_2_0 IS NOT NULL AND
node_property$PHP_5 IS NOT NULL"}
或 $AdminTask createPHPDynamicCluster dcName {-membershipPolicy "node_property$APACHE_2_0 IS NOT NULL AND
node_property$PHP_5 IS NOT NULL" -dynamicClusterProperties "{operationalMode automatic}{minInstances 1}
{maxInstances -1}{numVerticalInstances 1}" -clusterProperties "{templateName APACHE20_PHP5}"}
- 使用 Jython 字符串:
AdminTask.createPHPDynamicCluster(dcName,'[-membershipPolicy "node_property$APACHE_2_0 IS NOT NULL AND
node_property$PHP_5 IS NOT NULL" -dynamicClusterProperties "{{operationalMode automatic}{minInstances 1}
{maxInstances -1}{numVerticalInstances 1}}" -clusterProperties "{{templateName APACHE20_PHP5}}"]')
或者,如果您在
WebSphere Application Server V7.0 或更高版本上运行:
AdminTask.createPHPDynamicCluster('dcName','[-membershipPolicy "node_property$APACHE_2_0 IS NOT NULL AND
node_property$PHP_5 IS NOT NULL" -dynamicClusterProperties "[[operationalMode automatic][minInstances 1]
[maxInstances -1][numVerticalInstances 1]]" -clusterProperties "[[templateName APACHE20_PHP5]]"]')
交互方式示例用法
createDynamicClusterFromStaticCluster
使用 createDynamicClusterFromStaticCluster 命令可从现有静态集群创建新的动态集群。
可选参数
- -templateName:指定现有静态集群成员模板的名称。名称的格式必须是 cell_name/node_name/server_name 格式。如果未指定模板,那么将随机选择一个现有的静态集群成员模板。如果不存在任何成员,那么将使用缺省服务器模板。(字符串,可选)
- -dynamicClusterProperties:指定动态集群属性。(字符串,可选)可指定下列选项:
- operationalMode:指定运作方式。有效值是:manual、supervised 和 automatic。
- minInstances:将最小集群实例数指定为整数。
- serverInactivityTime:指定停止实例前等待的时间(以分钟计)。仅当将 minInstances 参数值设置为 0 时,此值才有效。
- maxInstances:将最大集群实例数指定为整数。如果不想限制可启动的集群实例的数量,请指定 -1。
返回值
该命令返回您创建的动态集群的 javax.management.ObjectName 值。
批处理方式示例用法
交互方式示例用法
createDynamicClusterFromForeignServers
使用
createDynamicClusterFromForeignServers 命令可创建辅助生命周期服务器的新的动态集群。创建动态集群之前,使用管理任务或在管理控制台中创建这些服务器的表示。
不推荐使用的功能部件: WebSphere Application Server V9.0 中已弃用辅助生命周期服务器和完整生命周期服务器。请将 WebSphere Liberty 服务器迁移至 Liberty 集合体配置。对于其他服务器类型,没有任何建议的迁移操作。
depfeat
必需参数
- -foreignServers [[node_name1 server_name1 ][node_name2
server_name2] ...]:指定现有的其他中间件服务器的节点和服务器的名称。(字符串,必需)
可选参数
- -dynamicClusterProperties:指定动态集群属性。(字符串,可选)可指定下列选项:
- operationalMode:指定运作方式。有效值是:manual、supervised 和 automatic。
- minInstances:将最小集群实例数指定为整数。
- serverInactivityTime:指定停止实例前等待的时间(以分钟计)。仅当将 minInstances 参数值设置为 0 时,此值才有效。
- maxInstances:将最大集群实例数指定为整数。如果不想限制可启动的集群实例的数量,请指定 -1。
返回值
该命令返回您更新的服务器类型的 javax.management.ObjectName 标识。
批处理方式示例用法
- 使用 Jacl:
$AdminTask createDynamicClusterFromForeignServers dcName {-foreignServers {{nodeName1 serverName1}
{nodeName2 serverName2}}}
- 使用 Jython 字符串:
AdminTask.createDynamicClusterFromForeignServers('dcName', '[-foreignServers [[nodeName1 serverName1]
[nodeName2 serverName2]]]')
交互方式示例用法
createODRDynamicCluster
使用 createODRDynamicCluster 命令创建随需应变路由器动态集群。
目标对象
指定动态集群的名称。
必需参数
membershipPolicy:指定成员资格策略。
可选参数
- -dynamicClusterProperties:指定动态集群属性。(字符串,可选)可指定下列选项:
- operationalMode:指定运作方式。有效值是:manual、supervised 和 automatic。
- minInstances:将最小集群实例数指定为整数。
- serverInactivityTime:指定停止实例前等待的时间(以分钟计)。仅当将 minInstances 参数值设置为 0 时,此值才有效。
- maxInstances:将最大集群实例数指定为整数。如果不想限制可启动的集群实例的数量,请指定 -1。
- numVerticalInstances:指定通过创建垂直实例可在相同节点上启动的实例数。请指定整数值。
- -clusterProperties:指定集群属性。(字符串,可选)可指定下列选项:
- preferLocal:指定是否将企业 Bean 请求路由到其上驻留客户机的节点(如果可能)。有效值是 true 或 false。
- createDomain:指定为此集群创建的复制域。仅可为 WebSphere Application Server 应用程序服务器创建复制域。有效值是 true 或 false。
- coreGroup:指定动态集群的核心组的名称。只需要指定 WebSphere Application Server 应用程序服务器的核心组。值可以是 DefaultCoreGroup 或核心组名称。
- templateName:指定服务器模板的名称。有效输入包括下列值:
- 对于 WebSphere Application Server 动态集群:defaultXD、defaultXDZOS 和 cell_name/node_name/was_server_name
clusterShortName:对于 z/OS 平台,请指定集群的短名称。创建动态集群后,可以使用 AdminTask changeClusterShortName 命令更新此字段。
serverSpecificShortNames:对于 z/OS 平台,以逗号分隔的列表格式指定集群成员的特定短名称,例如:SSN1,SSN2。使用逗号分隔多个短名称。如果没有提供供所有制集群成员使用的足够多的短名称,那么会为其余集群成员指定生成的通用短名称,例如,BBOS001, BBOS002 等。创建动态集群后,可以使用 serverSpecificShortNames 定制属性更新此列表。在动态集群上设置此属性。如果在创建动态集群后要使用脚本编制功能更改此属性,那么可以使用 AdminTask changeServerSpecificShortName 命令。
批处理方式示例用法
- 使用 Jacl:
$AdminTask createODRDynamicCluster dcName {parameters} {-membershipPolicy "node_nodegroup = 'DefaultNodeGroup' AND node_property$com.ibm.websphere.wxdopProductShortName = 'WXDOP'" -dynamicClusterProperties "{operationalMode automatic}{minInstances 2}" -clusterProperties "{templateName defaultXD}{preferLocal false}"}
- 使用 Jython 字符串:
AdminTask.createODRDynamicCluster('dcName', '[-membershipPolicy "node_nodegroup = 'DefaultNodeGroup' AND node_property$com.ibm.websphere.wxdopProductShortName = 'WXDOP'" -dynamicClusterProperties [[operationalMode automatic][minInstances 2]] -clusterProperties [[templateName defaultXD][preferLocal false]]]')
交互方式示例用法
addForeignServersToDynamicCluster
使用 addForeignServersToDynamicCluster 命令可将外部服务器添加到现有动态集群。
必需参数
- -foreignServers [[node_name1 server_name1 ][node_name2
server_name1] ...]:指定现有的其他中间件服务器的节点和服务器的名称。(字符串,必需)
返回值
该命令返回您更新的服务器类型的 javax.management.ObjectName 标识。
批处理方式示例用法
- 使用 Jacl:
$AdminTask addForeignServersToDynamicCluster dcName {-foreignServers {{nodeName1 serverName1}
{nodeName2 serverName2}}}
- 使用 Jython 字符串:
AdminTask.addForeignServersToDynamicCluster('dcName', '[-foreignServers [[nodeName1 serverName1]
[nodeName2 serverName2]]]')
交互方式示例用法
removeForeignServersFromDynamicCluster
使用 removeForeignServersFromDynamicCluster 命令可从动态集群移除外部服务器
必需参数
- -foreignServers [[node_name1 server_name1 ][node_name2
server_name1] ...]:指定现有的其他中间件服务器的节点和服务器的名称。(字符串,必需)
返回值
该命令返回您更新的服务器类型的 javax.management.ObjectName 标识。
批处理方式示例用法
- 使用 Jacl:
$AdminTask removeForeignServersFromDynamicCluster dcName {-foreignServers {{nodeName1 serverName1}{nodeName2 serverName2}}}
- 使用 Jython 字符串:
AdminTask.removeForeignServersFromDynamicCluster('dcName', '[-foreignServers [[nodeName1 serverName1] [nodeName2 serverName2]]]')
交互方式示例用法
deleteDynamicCluster
使用 deleteDynamicCluster 命令可从配置删除动态集群。
返回值
该命令返回您删除的动态集群的 javax.management.ObjectName 标识。
批处理方式示例用法
交互方式示例用法
getDynamicClusterMembers
使用 getDynamicClusterMembers 命令可显示指定的动态集群的成员以及节点名。如果未指定节点名,那么将显示动态集群的所有成员。
可选参数
- -nodeName:指定节点名称。(字符串,可选)
返回值
该命令返回 ClusterMember 对象的列表。
批处理方式示例用法
交互方式示例用法
getDynamicClusterOperationalMode
使用 getDynamicClusterOperationalMode 命令可显示动态集群的运作方式。
返回值
该命令返回 operationalMode 的值。String。
批处理方式示例用法
交互方式示例用法
getDynamicClusterMembershipPolicy
使用 getDynamicClusterMembershipPolicy 命令可显示动态集群成员资格策略。
返回值
该命令返回 membershipPolicy 的值。String。
批处理方式示例用法
交互方式示例用法
getDynamicClusterServerType
使用 getDynamicClusterServerType 命令可显示动态集群服务器类型。
返回值
该命令返回 serverType 的值。String。
批处理方式示例用法
交互方式示例用法
getDynamicClusterMinInstances
使用 getDynamicClusterMinInstances 命令可显示指定动态集群最小集群实例数。
返回值
该命令返回 minInstances 的值。整数。
批处理方式示例用法
交互方式示例用法
getDynamicClusterMaxInstances
使用 getDynamicClusterMaxInstances 命令可显示指定动态集群最大集群实例数。
返回值
该命令返回 maxInstances 的值。整数。
批处理方式示例用法
交互方式示例用法
getDynamicClusterVerticalInstances
使用 getDynamicClusterVerticalInstances 命令可显示节点上动态集群的垂直堆栈实例数。
返回值
该命令返回 numVerticalInstances 的值。整数。
批处理方式示例用法
交互方式示例用法
getDynamicClusterIsolationProperties
使用 getDynamicClusterVerticalInstances 命令可显示动态集群隔离属性。
返回值
该命令返回 isolationGroup 和 strictIsolationEnabled 的值。String。
批处理方式示例用法
交互方式示例用法
listDynamicClusters
使用 listDynamicClusters 命令可显示单元中的所有动态集群。
返回值
该命令返回每个动态集群名称。String。
批处理方式示例用法
交互方式示例用法
listDynamicClusterIsolationGroups
使用 listDynamicClusterIsolationGroups 命令可显示单元中的所有动态集群隔离组。
返回值
该命令返回动态集群隔离组的列表。String。
批处理方式示例用法
交互方式示例用法
listDynamicClusterIsolationGroupMembers
使用 listDynamicClusterIsolationGroupMembers 命令可显示指定隔离组的动态集群隔离组成员。
返回值
该命令返回动态集群隔离组成员的列表。String。
批处理方式示例用法
交互方式示例用法
modifyDynamicClusterIsolationProperties
使用 modifyDynamicClusterIsolationProperties 命令可修改动态集群隔离属性。
可选参数
- -isolationGroup:指定隔离组的名称。(字符串,可选)
- -strictIsolationEnabled:指示是否启用绝对隔离。(字符串,可选)
返回值
返回值为空。
批处理方式示例用法
- 使用 Jacl:
$AdminTask modifyDynamicClusterIsolationProperties dcName {-isolationGroup isolationGroupName -strictIsolationEnabled true}
- 使用 Jython 字符串:
AdminTask.modifyDynamicClusterIsolationProperties('dcName', '[-isolationGroup isolationGroupName -strictIsolationEnabled true]')
交互方式示例用法
setDynamicClusterOperationalMode
使用 setDynamicClusterOperationalMode 命令可设置动态集群的运作方式。
必需参数
- -operationalMode:指定动态集群的运作方式。将值设置为 automatic、manual 或 supervised。(字符串,必需)
返回值
返回值为空。
批处理方式示例用法
- 使用 Jacl:
$AdminTask setDynamicClusterOperationalMode dcName {-operationalMode manual}
- 使用 Jython 字符串:
AdminTask.setDynamicClusterOperationalMode('dcName', '[-operationalMode manual]')
交互方式示例用法
setDynamicClusterMembershipPolicy
使用 setDynamicClusterMembershipPolicy 命令可设置动态集群的成员资格策略。
必需参数
- -membershipPolicy
- 指定成员资格策略子表达式。(字符串,必需)
返回值
返回值为空。
批处理方式示例用法
- 使用 Jacl:
$AdminTask setDynamicClusterMembershipPolicy dcName {-membershipPolicy node_nodegroup='ngName'}
- 使用 Jython 字符串:
AdminTask.setDynamicClusterMembershipPolicy('dcName', '[-membershipPolicy node_nodegroup=\'ngName\']')
交互方式示例用法
setDynamicClusterMinInstances
使用 setDynamicClusterMinInstances 命令可设置动态集群最小集群实例数。
必需参数
- -minInstances
- 指定最小集群实例数。(整数,必需)
返回值
返回值为空。
批处理方式示例用法
- 使用 Jacl:
$AdminTask setDynamicClusterMinInstances dcName {-minInstances 1}
- 使用 Jython 字符串:
AdminTask.setDynamicClusterMinInstances('dcName', '[-minInstances 1]')
交互方式示例用法
setDynamicClusterMaxInstances
使用 setDynamicClusterMaxInstances 命令可设置动态集群最大集群实例数。
必需参数
- -maxInstances
- 指定最小集群实例数。(整数,必需)
返回值
返回值为空。
批处理方式示例用法
- 使用 Jacl:
$AdminTask setDynamicClusterMaxInstances dcName {-maxInstances -1}
- 使用 Jython 字符串:
AdminTask.setDynamicClusterMaxInstances('dcName', '[-maxInstances 1]')
交互方式示例用法
setDynamicClusterVerticalInstances
使用 setDynamicClusterVerticalInstances 命令可设置节点上动态集群的垂直堆栈实例数。
必需参数
- -numVerticalInstances
- 指定节点上的垂直堆栈实例。(整数,必需)
返回值
返回值为空。
批处理方式示例用法
- 使用 Jacl:
$AdminTask setDynamicClusterVerticalInstances dcName {-numVerticalInstances 2}
- 使用 Jython 字符串:
AdminTask.setDynamicClusterVerticalInstances('dcName', '[-numVerticalInstances 2]')
交互方式示例用法
testDynamicClusterMembershipPolicy
使用 testDynamicClusterMembershipPolicy 命令可测试动态集群成员资格策略以查看返回的节点。
必需参数
- -membershipPolicy
- 指定成员资格策略子表达式。(字符串,必需)
返回值
该命令返回节点名称的字符串 [] 列表。
批处理方式示例用法
交互方式示例用法
createNonWASDynamicCluster
使用 createNonWASDynamicCluster 命令可创建完整生命周期管理服务器的新动态集群。
可选参数
- -dynamicClusterProperties:指定动态集群属性。(字符串,可选)可指定下列选项:
- operationalMode:指定运作方式。有效值是:manual、supervised 和 automatic。
- minInstances:将最小集群实例数指定为整数。
- serverInactivityTime:指定停止实例前等待的时间(以分钟计)。仅当将 minInstances 参数值设置为 0 时,此值才有效。
- maxInstances:将最大集群实例数指定为整数。如果不想限制可启动的集群实例的数量,请指定 -1。
- numVerticalInstances:指定通过创建垂直实例可在相同节点上启动的实例数。请指定整数值。
- -clusterProperties:指定集群属性(字符串,可选)
- templateName:指定服务器模板的名称。有效输入包括下列值:
- 对于 PHP 动态集群:APACHE13_PHP4、APACHE13_PHP5、APACHE20_PHP4、APACHE20_PHP5、APACHE22_PHP4、APACHE22_PHP5 和 cellName/nodeName/php_serverName。
- 对于 WebSphere Application
Server Community Edition 动态集群:wasce20 和 cell_name/node_name/wasce_server_name
返回值
该命令返回您创建的动态集群的 javax.management.ObjectName 值。
批处理方式示例用法
- 使用 Jacl:
$AdminTask createNonWASDynamicCluster dcName {-serverType WASCE_SERVER -membershipPolicy
"node_property$com.ibm.websphere.wasceProductShortName = 'WASCE' OR node_property$WASCE_2.0.0.0
IS NOT NULL" -dynamicClusterProperties "{operationalMode automatic}{minInstances 1}{maxInstances -1}
{numVerticalInstances 1}" -clusterProperties "{templateName wasce20}"}
- 使用 Jython 字符串:
AdminTask.createNonWASDynamicCluster(dcName,'[-serverType WASCE_SERVER -membershipPolicy
"node_property$com.ibm.websphere.wasceProductShortName = \'WASCE\' OR node_property$WASCE_2.0.0.0
IS NOT NULL" -dynamicClusterProperties "{{operationalMode automatic}{minInstances 1}{maxInstances -1}
{numVerticalInstances 1}}" -clusterProperties "{{templateName wasce20}}"]')
或者,如果您在
WebSphere Application Server V7.0 或更高版本上运行:
AdminTask.createNonWASDynamicCluster('dcName','[-serverType WASCE_SERVER -membershipPolicy
"node_property$com.ibm.websphere.wasceProductShortName = \'WASCE\' OR node_property$WASCE_2.0.0.0
IS NOT NULL" -dynamicClusterProperties "[[operationalMode automatic][minInstances 1][maxInstances -1]
[numVerticalInstances 1]]" -clusterProperties "[[templateName wasce20]]"]')
交互方式示例用法
编辑动态集群服务器模板
标识动态集群服务器模板,并将模板指定到 serverid 变量。
批处理方式示例用法
- 使用 Jacl:
set serverid [$AdminConfig getid /Cell:mycell/DynamicCluster:mydynamiccluster/Server:mydynamiccluster/]
- 使用 Jython 字符串:
serverid = AdminConfig.getid('/Cell:mycell/DynamicCluster:mydynamiccluster/Server:mydynamiccluster/')
可以使用 serverid 变量修改、创建或删除动态集群服务器模板中的配置对象。