节点组配置脚本

该脚本编制库提供多个脚本过程来自动完成服务器配置。使用本主题中的信息来利用对节点配置进行查询、配置和管理的脚本。可以分别运行每个脚本,也可将过程组合在一起来为环境创建定制自动执行脚本。

使用节点组来定义可以管理同一集群的成员的节点组。部署至集群的应用程序必须能够在任何一个集群成员上运行。必须为管理各个集群成员的节点配置支持应用程序的必需软件和设置。

通过将满足您的应用程序需求的节点组织到一个节点组中,您就建立了管理可以一起使用哪些节点组成一个集群的管理策略。定义单元配置的人员和创建服务器集群的人员彼此可以较为独立地进行操作。

所有节点管理脚本过程都位于 app_server_root/scriptLibraries/system/V70 目录中。使用下列脚本过程来对节点配置进行查询、配置和管理:

addNodeGroupMember

此脚本将节点添加到配置中存在的节点组。

要运行该脚本,请指定节点和节点组的名称,如下表中所定义:
表 1. addNodeGroupMember 参数描述. 运行脚本以添加节点组成员。
自变量 描述
nodeName 指定节点组成员的逻辑名。节点组成员是一个节点。此名称在单元中必须是唯一的。节点组成员名通常与计算机的主机名相同。
nodeGroupName 指定节点组的逻辑名。此名称在单元中必须是唯一的。此名称可以是数字开头。

语法

AdminNodeGroupManagement.addNodeGroupMember(nodeName, discoveryProtocol)

用法示例

AdminNodeGroupManagement.addNodeGroupMember("myNode", "myNodeGroup")

checkIfNodeExists

此脚本会显示特定节点组中是否存在相关节点。

要运行该脚本,请指定节点组和节点参数,如下表中所定义:
表 2. checkIfNodeExists 参数描述. 运行脚本以查看节点是否存在于节点组中。
自变量 描述
nodeGroupName 指定要查询的节点组的名称。
nodeName 指定要查询的节点的名称。

语法

AdminNodeGroupManagement.checkIfNodeExists(nodeGroupName, nodeName)

用法示例

AdminNodeGroupManagement.checkIfNodeExists("myNodeGroup", "myNode")

checkIfNodeGroupExists

此脚本显示配置中是否存在特定节点组。

要运行该脚本,请指定节点组的名称,如下表中所定义:
表 3. checkIfNodeGroupExists 参数描述. 运行脚本以查看节点组是否存在。
自变量 描述
nodeGroupName 指定要查询的节点组的名称。

语法

AdminNodeGroupManagement.checkIfNodeGroupExists(nodeGroupName)

用法示例

AdminNodeGroupManagement.checkIfNodeGroupExists("myNodeGroup")

createNodeGroup

此脚本会在配置中创建新的节点组。

要运行该脚本,请指定节点组的名称,如下表中所定义:
表 4. createNodeGroup 参数描述. 运行脚本来创建节点组。
自变量 描述
nodeGroupName 指定要创建的节点组的名称。

语法

AdminNodeGroupManagement.createNodeGroup("nodeGroupName")

用法示例

AdminNodeGroupManagement.createNodeGroup("myNodeGroup")

createNodeGroupProperty

此脚本将定制属性指定给相关节点组。

要运行该脚本,请指定节点名称,如下表中所定义:
表 5. createNodeGroupProperty 参数描述. 运行脚本以指定节点组属性。
自变量 描述
nodeGroupName 指定相关节点的名称。
customPropertyName 指定属性的名称或关键字。每个属性名都必须是唯一的。如果多个属性使用了同一个名称,那么将使用对第一个具有该名称的属性指定的值。属性名不能以 was. 开头,因为此前缀已保留供应用程序服务器中预定义的属性使用。
customPropertyValue 指定要分配给定制属性名的值。
customPropertyDesc (可选)为要创建的定制属性指定描述。
isPropertyRequired (可选)指定定制属性在配置中是否为必需属性。指定 true 以在配置中将定制属性设置为必需属性。

语法

AdminNodeGroupManagement.createNodeGroupProperty(nodeGroupName, customPropertyName,
 customPropertyValue, customPropertyDesc, isPropertyRequired)

用法示例

AdminNodeGroupManagement.createNodeGroupProperty("myNodeGroup", "myProp", "myPropValue",
 "this is my prop", "true")

deleteNodeGroup

此脚本会从配置中删除节点组。

要运行该脚本,请指定节点组名称,如下表中所定义:
表 6. deleteNodeGroup 参数描述. 运行脚本来删除节点组。
自变量 描述
nodeGroupName 指定要删除的节点组的名称。

语法

AdminNodeGroupManagement.deleteNodeGroup(nodeGroupName)

用法示例

AdminNodeGroupManagement.deleteNodeGroup("myNodeGroup")

deleteNodeGroupMember

此脚本会从配置中的特定节点组中除去节点。

要运行该脚本,请指定节点组名称和节点名参数,如下表中所定义:
表 7. deleteNodeGroupMember 参数描述. 运行脚本以删除节点组成员。
自变量 描述
nodeGroupName 指定相关节点组的名称。
nodeName 指定要从节点组除去的节点的名称。

语法

AdminNodeGroupManagement.deleteNodeGroupMember(nodeGroupName, nodeName)

用法示例

AdminNodeGroupManagement.deleteNodeGroupMember("myNodeGroup", "myNode")

deleteNodeGroupProperty

此脚本会从节点组中除去特定定制属性。

要运行该脚本,请指定节点组名称和属性名参数,如下表中所定义:
表 8. deleteNodeGroupProperty 参数描述. 运行脚本来删除节点组属性。
自变量 描述
nodeGroupName 指定相关节点组的名称。
customPropertyName 指定要从节点组配置中除去的定制属性的名称。

语法

AdminNodeGroupManagement.deleteNodeGroupProperty(nodeGroupName, customPropertyName)

用法示例

AdminNodeGroupManagement.deleteNodeGroupProperty("myNodeGroup", "myProp")

help

此脚本显示 AdminNodeGroupManagement 脚本库支持的脚本过程。要显示特定脚本的详细帮助,请指定相关脚本的名称,如下表中所定义:
表 9. help 参数描述. 运行脚本来查看帮助。
自变量 描述
script 指定相关脚本的名称。

语法

AdminServerManagement.help(script)

用法示例

AdminServerManagement.help("modifyNodeGroupProperty")

listNodeGroups

此脚本会显示配置中存在的节点组。如果指定特定节点的名称,那么该脚本会返回该节点所属节点组的名称。
表 10. listNodeGroups 参数描述. 运行脚本以列示节点组。
自变量 描述
nodeName (可选)指定要用来查询节点组的节点的名称。

语法

AdminNodeGroupManagement.listNodeGroups()

用法示例

AdminNodeGroupManagement.listNodeGroups()

listNodeGroupMembers

此脚本列示在特定节点组内配置的每个节点的名称。

要运行该脚本,请指定节点组参数,如下表中所定义:
表 11. listNodeGroupMembers 参数描述. 运行脚本来查看节点组成员。
自变量 描述
nodeGroupName 指定相关节点组的名称。

语法

AdminNodeGroupManagement.listNodeGroupMembers(nodeGroupName)

用法示例

AdminNodeGroupManagement.listNodeGroupMembers("myNodeGroup")

listNodeGroupProperties

此脚本列示在特定节点组内配置的定制属性。

要运行该脚本,请指定节点组参数,如下表中所定义:
表 12. listNodeGroupProperties 参数描述. 运行脚本来查看节点组属性。
自变量 描述
nodeGroupName 指定相关节点组的名称。

语法

AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName)

用法示例

AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup")

modifyNodeGroup

此脚本修改节点组的短名称和描述。

要运行该脚本,请指定节点组、短名称和描述参数,如下表中所定义:
表 13. modifyNodeGroup 参数描述. 运行脚本来更改节点组。
自变量 描述
nodeGroupName 指定相关节点组的名称。
shortName 指定相关节点组的短名称。
description 指定节点组的描述。

语法

AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName, shortName, 
description)

用法示例

AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup", "NG1", "my first node group")

modifyNodeGroupProperty

此脚本修改指定给节点组的定制属性的值。

要运行该脚本,请指定节点组、定制属性、定制属性值、定制属性描述以及该属性是否为必需属性,如下表中所定义:
表 14. modifyNodeGroupProperty 参数描述. 运行脚本来更改节点组属性。
自变量 描述
nodeGroupName 指定相关节点组的名称。
customPropertyName 指定要修改的定制属性的名称。
customPropertyValue (可选)为相关定制属性指定新值。
customPropertyDescription (可选)为定制属性指定描述。
isPropertyRequired (可选)指定定制属性是否为必需属性。

语法

AdminNodeGroupManagement.modifyNodeGroupProperty(nodeGroupName, customPropertyName, 
customPropertyValue, customPropertyDescription, isPropertyRequired)

用法示例

AdminNodeGroupManagement.modifyNodeGroupProperty("myNodeGroup", "customProp", "newValue",
 "new description of property", "false")

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libnodegrp
文件名:rxml_7libnodegrp.html