節點群組配置 Script

Scripting 程式庫提供多個 Script 程序來自動執行伺服器配置。 請使用本主題中的資訊來使用 Script ，以查詢、配置及管理您的節點配置。 您可以個別執行每一個 Script ，或結合程序為您的環境建立自訂自動化 Script。

使用節點群組來定義節點群組可以管理相同叢集的成員。 部署至叢集的應用程式必須能夠在任何叢集成員上執行。 管理每一個叢集成員的節點必須配置支援應用程式所需的軟體和設定。

透過將滿足應用程式需求的節點組織成節點群組，您可以建立管理原則來控管可以一起使用哪些節點來形成叢集。 定義 Cell 配置的使用者和建立伺服器叢集的使用者可以彼此更獨立運作。

所有節點管理 Script 程序都位於 app_server_root/scriptLibraries/system/V70 目錄中。 使用下列 Script 程序來查詢、配置及管理節點配置:

addNodeGroupMember

此 Script 會將節點新增至存在於您配置中的節點群組。

如果要執行 Script ，請指定節點和節點群組的名稱，如下表中所定義:
表 1. addNodeGroupMember 引數說明 。 執行 Script 以新增節點群組成員。
引數 說明
nodeName 指定節點群組成員的邏輯名稱。 一個節點群組成員即是一個節點。 在 Cell 內，這個名稱必須是唯一的。 節點群組成員名稱通常與電腦的主機名稱相同。
節點群組名稱 指定節點群組的邏輯名稱。 在 Cell 內，這個名稱必須是唯一的。 名稱的開頭可為數字。

語法

AdminNodeGroupManagement.addNodeGroupMember(nodeName, discoveryProtocol)

範例用法

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

checkIfNodeExists

此 Script 會顯示感興趣的節點是否存在於特定的節點群組中。

如果要執行 Script ，請指定節點群組和節點引數，如下表中所定義:
表 2. checkIfNodeExists 引數說明 。 執行 Script 以查看節點群組中是否存在節點。
引數 說明
節點群組名稱 指定要查詢的節點群組名稱。
nodeName 指定要查詢的節點名稱。

語法

AdminNodeGroupManagement.checkIfNodeExists(nodeGroupName, nodeName)

範例用法

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

checkIfNodeGroupExists

這個 Script 會顯示您的配置中是否存在特定的節點群組。

如果要執行 Script ，請指定節點群組的名稱，如下表中所定義:
表 3. checkIfNodeGroupExists 引數說明 。 執行 Script 以查看節點群組是否存在。
引數 說明
節點群組名稱 指定要查詢的節點群組名稱。

語法

AdminNodeGroupManagement.checkIfNodeGroupExists(nodeGroupName)

範例用法

AdminNodeGroupManagement.checkIfNodeGroupExists("myNodeGroup")

createNodeGroup

這個 Script 會在您的配置中建立新的節點群組。

如果要執行 Script ，請指定節點群組的名稱，如下表中所定義:
表 4. createNodeGroup 引數說明 。 執行 Script 以建立節點群組。
引數 說明
節點群組名稱 指定要建立的節點群組名稱。

語法

AdminNodeGroupManagement.createNodeGroup("nodeGroupName")

範例用法

AdminNodeGroupManagement.createNodeGroup("myNodeGroup")

createNodeGroupProperty

此 Script 會將自訂內容指派給感興趣的節點群組。

若要執行 Script ，請指定節點的名稱，如下表中所定義:
表 5. createNodeGroupProperty 引數說明 。 執行 Script 以指定節點群組內容。
引數 說明
節點群組名稱 指定相關節點的名稱。
customPropertyName 指定內容的名稱（或索引鍵）。 每個內容名稱都必須是唯一的。 如果對多個內容使用了相同的名稱，則會使用為具有該名稱之第一個內容指定的值。 內容名稱開頭不為was.因為這個字首要保留給應用程式伺服器中預先定義的內容使用。
customPropertyValue 指定要指派給自訂內容名稱的值。
customPropertyDesc 選擇性地指定要建立之自訂內容的說明。
isPropertyRequired 選擇性地指定配置中是否需要自訂內容。 指定true在您的配置中視需要設定自訂內容。

語法

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

範例用法

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

deleteNodeGroup

這個 Script 會從您的配置中刪除節點群組。

如果要執行 Script ，請指定節點群組名稱，如下表中所定義:
表 6. deleteNodeGroup 引數說明 。 執行 Script 以刪除節點群組。
引數 說明
節點群組名稱 指定要刪除的節點群組名稱。

語法

AdminNodeGroupManagement.deleteNodeGroup(nodeGroupName)

範例用法

AdminNodeGroupManagement.deleteNodeGroup("myNodeGroup")

deleteNodeGroupMember

這個 Script 會從您配置中的特定節點群組移除節點。

如果要執行 Script ，請指定節點群組名稱和節點名稱引數，如下表中所定義:
表 7. deleteNodeGroupMember 引數說明 。 執行 Script 以刪除節點群組成員。
引數 說明
節點群組名稱 指定相關節點群組的名稱。
nodeName 指定要從節點群組中移除的節點名稱。

語法

AdminNodeGroupManagement.deleteNodeGroupMember(nodeGroupName, nodeName)

範例用法

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

deleteNodeGroupProperty

這個 Script 會從節點群組中移除特定的自訂內容。

如果要執行 Script ，請指定節點群組名稱和內容名稱引數，如下表中所定義:
表 8. deleteNodeGroupProperty 引數說明 。 執行 Script 以刪除節點群組內容。
引數 說明
節點群組名稱 指定相關節點群組的名稱。
customPropertyName 指定要從節點群組配置中移除的自訂內容名稱。

語法

AdminNodeGroupManagement.deleteNodeGroupProperty(nodeGroupName, customPropertyName)

範例用法

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

help

這個 Script 會顯示 AdminNodeGroupManagement Script 程式庫支援的 Script 程序。 如果要顯示特定 Script 的詳細說明，請指定您屬意之 Script 的名稱，如下表中的定義所示：
表 9. 說明引數說明 。 執行 Script 以檢視說明。
引數 說明
Script 指定您屬意之 Script 的名稱。

語法

AdminServerManagement.help(script)

範例用法

AdminServerManagement.help("modifyNodeGroupProperty")

listNodeGroups

這個 Script 會顯示存在於您配置中的節點群組。 如果您指定特定節點的名稱， Script 會傳回節點所屬的節點群組名稱。
表 10. listNodeGroups 引數說明 。 執行 Script 以列出節點群組。
引數 說明
nodeName 選擇性地指定要用來查詢節點群組的節點名稱。

語法

AdminNodeGroupManagement.listNodeGroups()

範例用法

AdminNodeGroupManagement.listNodeGroups()

listNodeGroupMembers

這個 Script 會列出在特定節點群組內配置的每一個節點名稱。

如果要執行 Script ，請指定節點群組引數，如下表中所定義:
表 11. listNodeGroupMembers 引數說明 。 執行 Script 以查看節點群組成員。
引數 說明
節點群組名稱 指定相關節點群組的名稱。

語法

AdminNodeGroupManagement.listNodeGroupMembers(nodeGroupName)

範例用法

AdminNodeGroupManagement.listNodeGroupMembers("myNodeGroup")

建立 Sysplex 節點群組

這個 Script 會列出在特定節點群組內配置的自訂內容。

如果要執行 Script ，請指定節點群組引數，如下表中所定義:
表 12. listNodeGroupProperties 引數說明 。 執行 Script 以查看節點群組內容。
引數 說明
節點群組名稱 指定相關節點群組的名稱。

語法

AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName)

範例用法

AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup")

modifyNodeGroup

這個 Script 會修改節點群組的簡稱和說明。

如果要執行 Script ，請指定節點群組、簡稱和說明引數，如下表中所定義:
表 13. modifyNodeGroup 引數說明 。 執行 Script 以變更節點群組。
引數 說明
節點群組名稱 指定相關節點群組的名稱。
shortName 指定相關節點群組的簡稱。
說明 指定節點群組的說明。

語法

AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName, shortName, 
description)

範例用法

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

從節點群組中移除內容

這個 Script 會修改指派給節點群組的自訂內容值。

如果要執行 Script ，請指定節點群組、自訂內容、自訂內容值、自訂內容說明，以及是否需要內容，如下表中所定義:
表 14. modifyNodeGroupProperty 引數說明 。 執行 Script 以變更節點群組內容。
引數 說明
節點群組名稱 指定相關節點群組的名稱。
customPropertyName 指定要修改的自訂內容名稱。
customPropertyValue 選擇性地指定相關自訂內容的新值。
customPropertyDescription 選擇性地指定自訂內容的說明。
isPropertyRequired 選擇性地指定是否需要自訂內容。

語法

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

範例用法

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