Scripts de configuration de groupe de noeuds

La bibliothèque de scripts propose de nombreuses procédures de script pour automatiser la configuration des serveurs. Consultez cette rubrique pour savoir comment utiliser les scripts qui interrogent, configurent et gèrent vos configurations de noeud. Vous pouvez exécuter chaque script individuellement ou combiner des procédures pour créer des scripts d'automatisation personnalisés pour votre environnement.

Les groupes de noeuds permettent de définir des groupes de noeuds capables d'héberger des membres du même cluster. Une application déployée sur un cluster doit être capable de s'exécuter sur n'importe quel membre du cluster. Le noeud qui héberge chacun des membres du cluster doit être configuré avec le logiciel et les paramètres nécessaires à la prise en charge de l'application.

En organisant des noeuds répondant aux besoins de votre application en groupes de noeuds, vous définissez une règle d'administration qui détermine les noeuds susceptibles d'être regroupés en cluster. Les personnes chargées de définir la configuration de la cellule et celles chargées de créer les clusters de serveurs bénéficient de plus d'indépendance dans leur travail.

Toutes les procédures de script de gestion de noeud sont disponibles dans le répertoire racine_serveur_app/scriptLibraries/system/V70. Utilisez les procédures de script suivantes pour interroger, configurer et gérer les configurations de noeud :

addNodeGroupMember

Ce script ajoute un noeud à un groupe de noeuds qui existe déjà dans votre configuration.

Pour exécuter le script, indiquez le nom du noeud et du groupe de noeuds (voir le tableau ci-dessous) :
Tableau 1. Description des arguments de addNodeGroupMember. Exécutez le script pour ajouter un membre de groupe de noeuds.
Argument Description
nodeName Spécifie un nom logique pour le membre du groupe de noeuds. Un membre de groupe de noeuds est un noeud. Le nom doit être unique dans la cellule. En général, le nom du membre du groupe de noeuds est identique au nom d'hôte de l'ordinateur.
nodeGroupName Spécifie un nom logique pour le groupe de noeuds. Le nom doit être unique dans la cellule. Il peut commencer par un chiffre.

Syntaxe

AdminNodeGroupManagement.addNodeGroupMember(nodeName, discoveryProtocol)

Exemple de syntaxe

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

checkIfNodeExists

Ce script détecte si le noeud recherché existe dans un groupe de noeuds spécifique.

Pour exécuter le script, spécifiez les arguments de noeud et de groupe de noeuds (voir le tableau ci-dessous) :
Tableau 2. Description des arguments de checkIfNodeExists. Exécutez le script pour vérifier si un noeud existe dans un groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds à interroger.
nodeName Indique le nom du noeud de noeuds à interroger.

Syntaxe

AdminNodeGroupManagement.checkIfNodeExists(nodeGroupName, nodeName)

Exemple de syntaxe

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

checkIfNodeGroupExists

Ce script détecte si un groupe de noeuds spécifique existe dans votre configuration.

Pour exécuter le script, indiquez le nom du groupe de noeuds (voir le tableau ci-dessous) :
Tableau 3. Description des arguments de checkIfNodeGroupExists. Exécutez le script pour vérifier si un groupe de noeuds existe.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds à interroger.

Syntaxe

AdminNodeGroupManagement.checkIfNodeGroupExists(nodeGroupName)

Exemple de syntaxe

AdminNodeGroupManagement.checkIfNodeGroupExists("myNodeGroup")

createNodeGroup

Ce script crée un nouveau groupe de noeuds dans votre configuration.

Pour exécuter le script, indiquez le nom du groupe de noeuds (voir le tableau ci-dessous) :
Tableau 4. Description des arguments de createNodeGroup. Exécutez le script pour créer un groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds à créer.

Syntaxe

AdminNodeGroupManagement.createNodeGroup("nodeGroupName")

Exemple de syntaxe

AdminNodeGroupManagement.createNodeGroup("myNodeGroup")

createNodeGroupProperty

Ce script affecte des propriétés personnalisées au groupe de noeuds qui vous intéresse.

Pour exécuter le script, indiquez le nom du noeud (voir le tableau ci-dessous) :
Tableau 5. Description des arguments de createNodeGroupProperty. Exécutez le script pour définir une propriété de groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du noeud qui vous intéresse.
customPropertyName Indique le nom ou la clé de la propriété. Chaque nom de propriété doit être unique. Si le même nom est utilisé pour plusieurs propriétés, la valeur spécifiée pour la première propriété portant ce nom est utilisée. Ne faites pas commencer les noms de propriétés par was car ce préfixe est réservé aux propriétés prédéfinies dans le serveur d'applications.
customPropertyValue Indique la valeur à attribuer à la propriété personnalisée.
customPropertyDesc Argument facultatif - Associe une description à la propriété personnalisée à créer.
isPropertyRequired Argument facultatif - Indique si la propriété personnalisée est obligatoire dans votre configuration. Spécifiez true pour rendre la propriété personnalisée obligatoire dans votre configuration.

Syntaxe

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

Exemple de syntaxe

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

deleteNodeGroup

Ce script supprime un groupe de noeuds de votre configuration.

Pour exécuter le script, indiquez le nom du groupe de noeuds (voir le tableau ci-dessous) :
Tableau 6. Description des arguments de deleteNodeGroup. Exécutez le script pour supprimer un groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds à supprimer.

Syntaxe

AdminNodeGroupManagement.deleteNodeGroup(nodeGroupName)

Exemple de syntaxe

AdminNodeGroupManagement.deleteNodeGroup("myNodeGroup")

deleteNodeGroupMember

Ce script supprime un noeud d'un groupe de noeuds spécifique dans votre configuration.

Pour exécuter le script, indiquez les arguments correspondant au nom du noeud et au nom du groupe de noeuds (voir le tableau ci-dessous) :
Tableau 7. Description des arguments de deleteNodeGroupMember. Exécutez le script pour supprimer un membre de groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds qui vous intéresse.
nodeName Indique le nom du noeud à supprimer du groupe de noeuds.

Syntaxe

AdminNodeGroupManagement.deleteNodeGroupMember(nodeGroupName, nodeName)

Exemple de syntaxe

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

deleteNodeGroupProperty

Ce script supprime une propriété personnalisée spécifique d'un groupe de noeuds.

Pour exécuter le script, indiquez les arguments correspondant au nom du groupe de noeuds et au nom de la propriété (voir le tableau ci-dessous) :
Tableau 8. Description des arguments de deleteNodeGroupProperty. Exécutez le script pour supprimer une propriété de groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds qui vous intéresse.
customPropertyName Indique le nom de la propriété personnalisée à supprimer de la configuration de votre groupe de noeuds.

Syntaxe

AdminNodeGroupManagement.deleteNodeGroupProperty(nodeGroupName, customPropertyName)

Exemple de syntaxe

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

help

Ce script affiche les procédures de script prises en charge par la bibliothèque de scripts AdminNodeGroupManagement. Pour accéder à l'aide détaillée d'un script spécifique, indiquez le nom du script qui vous intéresse, comme défini dans le tableau ci-après :
Tableau 9. Description des arguments de help. Exécutez le script pour afficher l'aide.
Argument Description
script Indique le nom du script qui vous intéresse.

Syntaxe

AdminServerManagement.help(script)

Exemple de syntaxe

AdminServerManagement.help("modifyNodeGroupProperty")

listNodeGroups

Ce script affiche les groupes de noeuds qui existent dans votre configuration. Si vous indiquez le nom d'un noeud spécifique, le script renvoie le nom du groupe de noeuds auquel le noeud appartient.
Tableau 10. Description des arguments de listNodeGroups. Exécutez le script pour afficher la liste des groupes de noeuds.
Argument Description
nodeName Argument facultatif - Indique le nom du noeud à utiliser pour interroger les groupes de noeuds.

Syntaxe

AdminNodeGroupManagement.listNodeGroups()

Exemple de syntaxe

AdminNodeGroupManagement.listNodeGroups()

listNodeGroupMembers

Ce script répertorie tous les noms de noeud configurés au sein d'un groupe de noeuds spécifique.

Pour exécuter le script, indiquez le nom du groupe de noeuds en tant qu'argument (voir le tableau ci-dessous) :
Tableau 11. Description des arguments de listNodeGroupMembers. Exécutez le script pour visualiser des membres de groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds qui vous intéresse.

Syntaxe

AdminNodeGroupManagement.listNodeGroupMembers(nodeGroupName)

Exemple de syntaxe

AdminNodeGroupManagement.listNodeGroupMembers("myNodeGroup")

listNodeGroupProperties

Ce script répertorie les propriétés personnalisées configurées au sein d'un groupe de noeuds spécifique.

Pour exécuter le script, indiquez le nom du groupe de noeuds en tant qu'argument (voir le tableau ci-dessous) :
Tableau 12. Description des arguments de listNodeGroupProperties. Exécutez le script pour visualiser des propriétés de groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds qui vous intéresse.

Syntaxe

AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName)

Exemple de syntaxe

AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup")

modifyNodeGroup

Ce script modifie le nom abrégé et la description d'un groupe de noeuds.

Pour exécuter le script, indiquez les arguments correspondant au nom, au nom abrégé et à la description du groupe de noeuds (voir le tableau ci-dessous) :
Tableau 13. Description des arguments de modifyNodeGroup. Exécutez le script pour modifier un groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds qui vous intéresse.
shortName Indique le nom abrégé du groupe de noeuds qui vous intéresse.
description Indique la description du groupe de noeuds.

Syntaxe

AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName, shortName, 
description)

Exemple de syntaxe

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

modifyNodeGroupProperty

Ce script modifie la valeur d'une propriété personnalisée associée à un groupe de noeuds.

Pour exécuter le script, spécifiez le groupe de noeuds, la propriété personnalisée, la valeur associée à cette propriété, la description de celle-ci ainsi que le caractère obligatoire (ou non) de cette propriété (voir le tableau ci-dessous) :
Tableau 14. Description des arguments de modifyNodeGroupProperty. Exécutez le script pour modifier une propriété de groupe de noeuds.
Argument Description
nodeGroupName Indique le nom du groupe de noeuds qui vous intéresse.
customPropertyName Indique le nom de la propriété personnalisée à modifier.
customPropertyValue Argument facultatif - Indique la nouvelle valeur de la propriété personnalisée qui vous intéresse.
customPropertyDescription Argument facultatif - Associe une description à la propriété personnalisée.
isPropertyRequired Argument facultatif - Spécifie si la propriété personnalisée est obligatoire.

Syntaxe

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

Exemple de syntaxe

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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libnodegrp
Nom du fichier : rxml_7libnodegrp.html