节点组配置脚本
该脚本编制库提供多个脚本过程来自动完成服务器配置。使用本主题中的信息来利用对节点配置进行查询、配置和管理的脚本。可以分别运行每个脚本,也可将过程组合在一起来为环境创建定制自动执行脚本。
使用节点组来定义可以管理同一集群的成员的节点组。部署至集群的应用程序必须能够在任何一个集群成员上运行。必须为管理各个集群成员的节点配置支持应用程序的必需软件和设置。
通过将满足您的应用程序需求的节点组织到一个节点组中,您就建立了管理可以一起使用哪些节点组成一个集群的管理策略。定义单元配置的人员和创建服务器集群的人员彼此可以较为独立地进行操作。
所有节点管理脚本过程都位于 app_server_root/scriptLibraries/system/V70 目录中。使用下列脚本过程来对节点配置进行查询、配置和管理:
addNodeGroupMember
此脚本将节点添加到配置中存在的节点组。
要运行该脚本,请指定节点和节点组的名称,如下表中所定义:
自变量 | 描述 |
---|---|
nodeName | 指定节点组成员的逻辑名。节点组成员是一个节点。此名称在单元中必须是唯一的。节点组成员名通常与计算机的主机名相同。 |
nodeGroupName | 指定节点组的逻辑名。此名称在单元中必须是唯一的。此名称可以是数字开头。 |
语法
AdminNodeGroupManagement.addNodeGroupMember(nodeName, discoveryProtocol)
用法示例
AdminNodeGroupManagement.addNodeGroupMember("myNode", "myNodeGroup")
checkIfNodeExists
此脚本会显示特定节点组中是否存在相关节点。
要运行该脚本,请指定节点组和节点参数,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定要查询的节点组的名称。 |
nodeName | 指定要查询的节点的名称。 |
语法
AdminNodeGroupManagement.checkIfNodeExists(nodeGroupName, nodeName)
用法示例
AdminNodeGroupManagement.checkIfNodeExists("myNodeGroup", "myNode")
checkIfNodeGroupExists
此脚本显示配置中是否存在特定节点组。
要运行该脚本,请指定节点组的名称,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定要查询的节点组的名称。 |
语法
AdminNodeGroupManagement.checkIfNodeGroupExists(nodeGroupName)
用法示例
AdminNodeGroupManagement.checkIfNodeGroupExists("myNodeGroup")
createNodeGroup
此脚本会在配置中创建新的节点组。
要运行该脚本,请指定节点组的名称,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定要创建的节点组的名称。 |
语法
AdminNodeGroupManagement.createNodeGroup("nodeGroupName")
用法示例
AdminNodeGroupManagement.createNodeGroup("myNodeGroup")
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
此脚本会从配置中删除节点组。
要运行该脚本,请指定节点组名称,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定要删除的节点组的名称。 |
语法
AdminNodeGroupManagement.deleteNodeGroup(nodeGroupName)
用法示例
AdminNodeGroupManagement.deleteNodeGroup("myNodeGroup")
deleteNodeGroupMember
此脚本会从配置中的特定节点组中除去节点。
要运行该脚本,请指定节点组名称和节点名参数,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定相关节点组的名称。 |
nodeName | 指定要从节点组除去的节点的名称。 |
语法
AdminNodeGroupManagement.deleteNodeGroupMember(nodeGroupName, nodeName)
用法示例
AdminNodeGroupManagement.deleteNodeGroupMember("myNodeGroup", "myNode")
deleteNodeGroupProperty
此脚本会从节点组中除去特定定制属性。
要运行该脚本,请指定节点组名称和属性名参数,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定相关节点组的名称。 |
customPropertyName | 指定要从节点组配置中除去的定制属性的名称。 |
语法
AdminNodeGroupManagement.deleteNodeGroupProperty(nodeGroupName, customPropertyName)
用法示例
AdminNodeGroupManagement.deleteNodeGroupProperty("myNodeGroup", "myProp")
help
此脚本显示 AdminNodeGroupManagement
脚本库支持的脚本过程。要显示特定脚本的详细帮助,请指定相关脚本的名称,如下表中所定义:
自变量 | 描述 |
---|---|
script | 指定相关脚本的名称。 |
语法
AdminServerManagement.help(script)
用法示例
AdminServerManagement.help("modifyNodeGroupProperty")
listNodeGroups
此脚本会显示配置中存在的节点组。如果指定特定节点的名称,那么该脚本会返回该节点所属节点组的名称。
自变量 | 描述 |
---|---|
nodeName | (可选)指定要用来查询节点组的节点的名称。 |
语法
AdminNodeGroupManagement.listNodeGroups()
用法示例
AdminNodeGroupManagement.listNodeGroups()
listNodeGroupMembers
此脚本列示在特定节点组内配置的每个节点的名称。
要运行该脚本,请指定节点组参数,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定相关节点组的名称。 |
语法
AdminNodeGroupManagement.listNodeGroupMembers(nodeGroupName)
用法示例
AdminNodeGroupManagement.listNodeGroupMembers("myNodeGroup")
listNodeGroupProperties
此脚本列示在特定节点组内配置的定制属性。
要运行该脚本,请指定节点组参数,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定相关节点组的名称。 |
语法
AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName)
用法示例
AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup")
modifyNodeGroup
此脚本修改节点组的短名称和描述。
要运行该脚本,请指定节点组、短名称和描述参数,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定相关节点组的名称。 |
shortName | 指定相关节点组的短名称。 |
description | 指定节点组的描述。 |
语法
AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName, shortName,
description)
用法示例
AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup", "NG1", "my first node group")
modifyNodeGroupProperty
此脚本修改指定给节点组的定制属性的值。
要运行该脚本,请指定节点组、定制属性、定制属性值、定制属性描述以及该属性是否为必需属性,如下表中所定义:
自变量 | 描述 |
---|---|
nodeGroupName | 指定相关节点组的名称。 |
customPropertyName | 指定要修改的定制属性的名称。 |
customPropertyValue | (可选)为相关定制属性指定新值。 |
customPropertyDescription | (可选)为定制属性指定描述。 |
isPropertyRequired | (可选)指定定制属性是否为必需属性。 |
语法
AdminNodeGroupManagement.modifyNodeGroupProperty(nodeGroupName, customPropertyName,
customPropertyValue, customPropertyDescription, isPropertyRequired)
用法示例
AdminNodeGroupManagement.modifyNodeGroupProperty("myNodeGroup", "customProp", "newValue",
"new description of property", "false")