Utilisation du groupe de commandes JobManagerNode de l'objet AdminTask avec les scripts de wsadmin
Le langage de script Jython permet de gérer les paramètres du gestionnaire de travaux à l'aide de l'outil wsadmin. Les commandes et paramètres du groupe JobManagerNode peuvent être utilisés pour enregistrer auprès du gestionnaire de travaux les cibles qui ne comportent pas d'agent d'administration.
Utilisez les commandes dont le nom comporte le terme Target : cleanupTarget, queryTargets, getTargetProperties, modifyTargetProperties et getTargetKeys. Ces commandes remplacent des commandes obsolètes qui contiennent ManagedNode dans leur nom.

- cleanupManagedNode (obsolète)
- cleanupTarget
- getContexts
- getManagedNodeKeys (obsolète)
- getTargetKeys
- getManagedNodeProperties (obsolète)
- getTargetProperties
- getManagedResourceProperties
- getManagedResourcePropertyKeys
- getManagedResourceTypes
- modifyManagedNodeProperties (obsolète)
- modifyTargetProperties
- queryManagedNodes (obsolète)
- queryTargets
- queryManagedResources
- registerHost
- unregisterHost
cleanupManagedNode (obsolète)
La commande cleanupManagedNode nettoie les informations d'enregistrement d'un noeud géré. Cette commande permet, en cas d'échec de la suppression d'un noeud du gestionnaire de travaux, d'effacer explicitement les informations d'enregistrement présentes dans le gestionnaire de travaux. La commande ne supprime pas l'historique du travail pour le noeud. Les travaux en cours poursuivent leur exécution, mais les nouveaux travaux ne démarrent pas pour le noeud concerné.
Objet cible
Aucun
Paramètres obligatoires
- -managedNodeName
- Indique le nom du noeud concerné. (Chaîne, obligatoire)
Valeur renvoyée
La commande renvoie l'identificateur unique universel (UUID) du gestionnaire de travaux que le système a nettoyé.
Syntaxe d'un exemple de mode différé
- A l'aide de la chaîne Jython :
AdminTask.cleanupManagedNode('-managedNodeName Node1')
- Avec une liste Jython :
AdminTask.cleanupManagedNode(['-managedNodeName', 'Node1'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.cleanupManagedNode('-interactive')
cleanupTarget
La commande cleanupTarget nettoie les informations d'enregistrement d'une cible. Cette commande permet, en cas d'échec de la suppression d'une cible du gestionnaire de travaux, d'effacer explicitement les informations d'enregistrement présentes dans le gestionnaire de travaux. La commande ne supprime pas l'historique du travail pour la cible. Les travaux en cours poursuivent leur exécution, mais les nouveaux travaux ne démarrent pas pour la cible concernée.
Objet cible
Aucun
Paramètres obligatoires
- -targetName
- Indique le nom de la cible qui vous intéresse. (Chaîne, obligatoire)
Valeur renvoyée
La commande renvoie l'identificateur unique universel (UUID) du gestionnaire de travaux que le système a nettoyé.
Syntaxe d'un exemple de mode différé
- A l'aide de la chaîne Jython :
AdminTask.cleanupTarget('-targetName Target1')
- Avec une liste Jython :
AdminTask.cleanupTarget(['-targetName', 'Target1'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.cleanupTarget('-interactive')
getContexts
La commande getContexts affiche tous les contextes du modèle de gestion, y compris les noeuds et serveurs.
Objet cible
Aucun
Paramètres obligatoires
Aucun
Valeur renvoyée
La commande renvoie la liste de tous les chemins de contexte.
Syntaxe d'un exemple de mode différé
- A l'aide de la chaîne Jython :
AdminTask.getContexts()
- Avec une liste Jython :
AdminTask.getContexts()
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.getContexts('-interactive')
getManagedNodeKeys (obsolète)
La commande getManagedNodeKeys affiche les clés à utiliser pour rechercher les noeuds gérés, y compris les clés nom, alias et uuid.
Objet cible
Aucun
Paramètres facultatifs
- -managedNodeName
- Indique le nom du noeud concerné. (Chaîne, facultatif)
Valeur renvoyée
La commande renvoie la liste des clés.
Exemple d'utilisation en mode de traitement par lots
- A l'aide de la chaîne Jython :
AdminTask.getManagedNodeKeys('-managedNodeName Node1')
- Avec une liste Jython :
AdminTask.getManagedNodeKeys(['-managedNodeName', 'Node1'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.getManagedNodeKeys('-interactive')
getTargetKeys
La commande getTargetKeys affiche les clés à utiliser pour rechercher les cibles, y compris les clés nom, alias et uuid.
Objet cible
Aucun
Paramètres facultatifs
- -targetName
- Indique le nom de la cible qui vous intéresse. (Chaîne, facultatif)
Valeur renvoyée
La commande renvoie la liste des clés.
Exemple d'utilisation en mode de traitement par lots
- A l'aide de la chaîne Jython :
AdminTask.getTargetKeys('-targetName Target1')
- Avec une liste Jython :
AdminTask.getTargetKeys(['-targetName', 'Target1'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.getTargetKeys('-interactive')
getManagedNodeProperties (obsolète)
La commande getManagedNodeProperties affiche les propriétés d'un ou plusieurs noeuds gérés ou non gérés.
Objet cible
Aucun
Paramètres facultatifs
- -managedNodeNameList
- Indique une liste de noms des noeuds qui vous intéressent. (Chaîne[], facultatif)
Valeur renvoyée
La commande renvoie une liste des propriétés pour chaque noeud défini à l'aide du paramètre -managedNodeNameList.
Exemple d'utilisation en mode de traitement par lots
- A l'aide de la chaîne Jython :
AdminTask.getManagedNodeProperties('-managedNodeNameList "[Node1 Node2]"')
- Avec une liste Jython :
AdminTask.getManagedNodeProperties(['-managedNodeNameList', '[Node1 Node2]'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.getManagedNodeProperties('-interactive')
getTargetProperties
La commande getTargetProperties affiche les propriétés d'une ou plusieurs cibles.
Objet cible
Aucun
Paramètres facultatifs
- -targetNameList
- Indique une liste de noms des cibles qui vous intéressent. (Chaîne[], facultatif)
Valeur renvoyée
La commande renvoie une liste des propriétés pour chaque cible indiquée à l'aide du paramètre -targetNameList.
Exemple d'utilisation en mode de traitement par lots
- A l'aide de la chaîne Jython :
AdminTask.getTargetProperties('-targetNameList "[Target1 Target2]"')
- Avec une liste Jython :
AdminTask.getTargetProperties(['-targetNameList', '[Target1 Target2]'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.getTargetProperties('-interactive')
getManagedResourceProperties
La commande getManagedResourceProperties affiche les propriétés d'une ou plusieurs ressources gérées. Les ressources gérées sont des instances figurant dans contexte de noeud ou de serveur. Par exemple, un contexte de serveur peut inclure les ressources gérées serveur1, serveur2 ou serveur3.
Objet cible
Aucun
Paramètres obligatoires
- -resourceIdList
- Indique la liste des identificateurs uniques affectés aux ressources qui vous intéressent. (Chaîne, facultatif)
Valeur renvoyée
La commande renvoie une liste de propriétés pour chaque ressource gérée.
Syntaxe d'un exemple de mode différé
- A l'aide de la chaîne Jython :
AdminTask.getManagedResourceProperties('-resourceIdList AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb /nodes/myNode/servers/server1')
- Avec une liste Jython :
AdminTask.getManagedResourceProperties('-resourceIdList', 'AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb /nodes/myNode/servers/server1')
Exemple d'utilisation en mode interactif
- Avec Jython :
AdminTask.getManagedResourceProperties('-interactive')
getManagedResourcePropertyKeys
La commande getManagedResourcePropertyKeys affiche les clés de propriétés d'un type spécifique de ressources gérées.
Objet cible
Aucun.
Paramètres requis
- -resourceType
- Indique le type de ressource gérée qui vous intéresse. (Chaîne, obligatoire)
Valeur renvoyée
La commande renvoie une liste de clés de ressource gérée pour le type de ressource concerné.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.getManagedResourcePropertyKeys('-resourceType server')
- Avec la liste Jython :
AdminTask.getManagedResourcePropertyKeys('-resourceType', 'server')
Exemple d'utilisation en mode interactif
- Avec Jython :
AdminTask.getManagedResourcePropertyKeys('-interactive')
getManagedResourceTypes
La commande getManagedResourceTypes affiche chacun des types de ressource gérée.
Objet cible
Aucun.
Paramètres requis
Aucun.
Valeur renvoyée
La commande renvoie la liste des types de ressource gérée.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.getManagedResourceTypes()
- Avec la liste Jython :
AdminTask.getManagedResourceTypes()
Exemple d'utilisation en mode interactif
- Avec Jython :
AdminTask.getManagedResourceTypes('-interactive')
modifyManagedNodeProperties (obsolète)
La commande modifyManagedNodeProperties remplace les propriétés dans une configuration de noeud géré. Si le noeud géré comporte un agent d'administration, la commande ne modifie que la propriété alias. Si le noeud géré ne comporte pas d'agent d'administration, la commande remplace toutes les propriétés.
Objet cible
Aucun.
Paramètres requis
- -managedNodeName
- Indique le nom du noeud qui vous intéresse. (Chaîne, obligatoire)
- -managedNodeProps
- Indique les paires de propriétés nom/valeur à modifier pour le noeud qui vous intéresse. (Propriétés, obligatoire)
Paramètres facultatifs
- -replace
- Indique si les propriétés existantes doivent être remplacées. Indiquez true pour remplacer les propriétés existantes. Indiquez false pour fusionner les propriétés. La valeur par défaut est false. (Booléen, facultatif)
Valeur renvoyée
La commande ne renvoie pas de sortie.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.modifyManagedNodeProperties('-managedNodeName Node1 -managedNodeProps "[alias myNewAlias]"')
- Avec la liste Jython :
AdminTask.modifyManagedNodeProperties('-managedNodeName', 'Node1', '-managedNodeProps', '[alias myNewAlias]')
Exemple d'utilisation en mode interactif
- Avec Jython :
AdminTask.modifyManagedNodeProperties('-interactive')
modifyTargetProperties
La commande modifyTargetProperties remplace les propriétés dans une configuration de cible. Si la cible comporte un agent d'administration, la commande ne modifie que la propriété alias. Si la cible ne comporte pas d'agent d'administration, la commande remplace toutes les propriétés.
Objet cible
Aucun.
Paramètres requis
- -targetName
- Indique le nom de la cible qui vous intéresse. (Chaîne, obligatoire)
- -targetProps
- Indique les paires de propriétés nom/valeur à modifier pour la cible qui vous intéresse. (Propriétés, obligatoire)
Paramètres facultatifs
- -replace
- Indique si les propriétés existantes doivent être remplacées. Indiquez true pour remplacer les propriétés existantes. Indiquez false pour fusionner les propriétés. La valeur par défaut est false. (Booléen, facultatif)
Valeur renvoyée
La commande ne renvoie pas de sortie.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.modifyTargetProperties('-targetName Target1 -targetProps "[alias myNewAlias]"')
- Avec la liste Jython :
AdminTask.modifyTargetProperties('-targetName', 'Target1', '-targetProps', '[alias myNewAlias]')
Exemple d'utilisation en mode interactif
- Avec Jython :
AdminTask.modifyTargetProperties('-interactive')
queryManagedNodes (obsolète)
La commande queryManagedNodes recherche les noeuds gérés d'après une expression de requête. Si vous n'indiquez pas d'expression de requête, la commande renvoie tous les noeuds gérés.
Objet cible
Aucun.
Paramètres requis
- -maxReturn
- Indique le nombre maximal de noeuds gérés à renvoyer. (Entier, obligatoire)
Paramètres facultatifs
- -query
- Indique une requête composée d'une ou de plusieurs expressions de
requête séparées par un espace. Si vous n'indiquez pas ce paramètre, la
commande renvoie tous les noeuds gérés. (Chaîne, facultatif)Construisez vos requêtes conformément aux instructions suivantes :
- Chaque expression de requête comprend les éléments key (clé), operator (opérateur) et value (valeur).
- Les opérateurs suivants sont pris en charge :
Tableau 1. Opérateurs de queryManagedNodes -query. Utiliser un opérateur dans une requête. Caractère Valeur = Egal à. Pour indiquer une valeur NULL, utilisez = NULL. != Différent de. Pour indiquer une valeur non NULL, utilisez = NULL. > Supérieur à < Inférieur à >= Supérieur ou égal à <= Inférieur ou égal à - Vous pouvez indiquer une valeur unique ou plusieurs valeurs séparées par une virgule.
- Vous pouvez indiquer la valeur à l'aide de masques de correspondance.
- -validate
- Indique si la requête de recherche doit être validée. (Booléen, facultatif)
Valeur renvoyée
La commande renvoie le nombre de correspondances trouvées par la requête. Elle renvoie également la liste des noeuds gérés qui satisfont au critère de la requête de recherche.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.queryManagedNodes('-maxReturn 20 -query "managedNodeName=Node1" -validate true')
- Avec la liste Jython :
AdminTask.queryManagedNodes(['-maxReturn', '20', '-query', 'managedNodeName=Node1', '-validate', 'true'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.queryManagedNodes('-interactive')
queryTargets
La commande queryTargets recherche les cibles d'après une expression de requête. Si vous n'indiquez pas d'expression de requête, la commande renvoie toutes les cibles.
Objet cible
Aucun.
Paramètres requis
- -maxReturn
- Indique le nombre maximal de cibles à renvoyer. (Entier, obligatoire)
Paramètres facultatifs
- -query
- Indique une requête composée d'une ou de plusieurs expressions de
requête séparées par un espace. Si vous n'indiquez pas ce paramètre, la
commande renvoie toutes les cibles. (Chaîne, facultatif)Construisez vos requêtes conformément aux instructions suivantes :
- Chaque expression de requête comprend les éléments key (clé), operator (opérateur) et value (valeur).
- Les opérateurs suivants sont pris en charge :
Tableau 2. Opérateurs de queryTargets -query. Utiliser un opérateur dans une requête. Caractère Valeur = Egal à. Pour indiquer une valeur NULL, utilisez = NULL. != Différent de. Pour indiquer une valeur non NULL, utilisez = NULL. > Supérieur à < Inférieur à >= Supérieur ou égal à <= Inférieur ou égal à - Vous pouvez indiquer une valeur unique ou plusieurs valeurs séparées par une virgule.
- Vous pouvez indiquer la valeur à l'aide de masques de correspondance.
- -validate
- Indique si la requête de recherche doit être validée. (Booléen, facultatif)
Valeur renvoyée
La commande renvoie le nombre de correspondances trouvées par la requête. Elle renvoie également la liste des cibles qui satisfont au critère de la requête de recherche.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.queryTargets('-maxReturn 20 -query "targetName=target1" -validate true')
- Avec la liste Jython :
AdminTask.queryTargets(['-maxReturn', '20', '-query', 'targetName=target1', '-validate', 'true'])
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.queryTargets('-interactive')
queryManagedResources
La commande queryManagedResources recherche, dans vos ressources gérées, des noeuds gérés spécifiques d'après une expression de requête.
Objet cible
Aucun.
Paramètres requis
- -maxReturn
- Indique le nombre maximal de ressources gérées à renvoyer. (Entier, obligatoire)
Paramètres facultatifs
- -query
- Indique une requête composée d'une ou de plusieurs expressions de
requête séparées par un espace. Si vous n'indiquez pas ce paramètre, la
commande renvoie tous les noeuds gérés. (Chaîne, facultatif)Construisez vos requêtes conformément aux instructions suivantes :
- Chaque expression de requête comprend les éléments key (clé), operator (opérateur) et value (valeur).
- Les opérateurs suivants sont pris en charge :
Tableau 3. Opérateurs queryManagedResources -query. Utiliser un opérateur dans une requête. Caractère Valeur = Egal à. Pour indiquer une valeur NULL, utilisez = NULL. != Différent de. Pour indiquer une valeur non NULL, utilisez = NULL. > Supérieur à < Inférieur à >= Supérieur ou égal à <= Inférieur ou égal à - Vous pouvez indiquer une valeur unique ou plusieurs valeurs séparées par une virgule.
- Vous pouvez indiquer la valeur à l'aide de masques de correspondance.
- -validate
- Indique si la requête de recherche doit être validée. (Booléen, facultatif)
Valeur renvoyée
La commande renvoie le nombre de correspondances trouvées par la requête. Elle renvoie également la liste des identificateurs uniques universels (UUID) des noeuds gérés qui satisfont au critère de la requête de recherche.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.queryManagedResources('-maxReturn 20 -query "alias=managedNode1"')
- Avec la liste Jython :
AdminTask.queryManagedResources('-maxReturn', '20', '-query', '"alias=managedNode1"')
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.queryManagedResources('-interactive')
registerHost
La commande registerHost définit une cible d'hôte distant auprès du gestionnaire de travaux. Utilisez la commande registerHost pour :
- Enregistrer une cible d'hôte distant auprès du gestionnaire de travaux. A la différence des cibles qui sont des profils WebSphere Application Server et sont enregistrées à l'aide de la commande registerWithJobManager auprès du gestionnaire de déploiement ou de l'agent d'administration, il n'est pas nécessaire que des produits WebSphere Application Server soient installés sur une cible d'hôte distant. Aucune configuration logicielle n'est requise pour cet hôte à part son système d'exploitation.
- Collecter un inventaire de l'hôte distant. Des informations concernant les ressources gérées et les types de travaux sont disponibles une fois la commande registerHost exécutée.
Vous pouvez utiliser les cibles d'hôte distant de la même manière que les cibles enregistrés à l'aide de la commande registerWithJobManager, mais les types de travaux disponibles pour une cible d'hôte distant sont différents.
Objet cible
Aucun.
Paramètres requis
- -host
- Indique le nom de l'ordinateur distant à enregistrer auprès du gestionnaire des travaux. (Chaîne, obligatoire)
- -hostProps
- Indique les propriétés de l'hôte. Vous pouvez définir toutes les propriétés que vous vous souhaitez. Les propriétés définies dans le tableau affectent le comportement de la commande. (Chaîne, obligatoire)
Tableau 4. Propriétés définies pour registerHost -hostProps. Vous pouvez spécifier une ou plusieurs propriétés pour la commande registerHost, ou indiquer des propriétés non définies pour cette commande. Nom de la propriété Description de la propriété osType Type du système d'exploitation. Indiquez osType pour permettre à la commande de s'exécuter plus rapidement. Cette propriété facultative détermine les méthodes de connexion avec l'hôte. Les valeurs valides sont les suivantes : - aix
- hpux
- os400
- linux
- solaris
- windows
- os390
nom_utilisateur Utilisateur disposant de droits permettant de se connecter à l'hôte. Cette propriété est requise. password Mot de passe pour le nom d'utilisateur fourni. Une valeur doit être spécifiée pour password ou privateKeyFile. Si l'hôte cible n'exige pas de mot de passe, vous pouvez indiquer la valeur de chaîne nulle "". privateKeyFile Chemin du fichier de clés privées. Si vous ne spécifiez pas de valeur pour password, vous devez en indiquer une pour privateKeyFile. passphrase Phrase passe pour le fichier de clés privées, le cas échéant. saveSecurity Indique s'il faut stocker avec l'hôte des propriétés de sécurité (username, password, privateKeyFile, passphrase) à utiliser comme valeurs par défaut pour les soumissions de travaux. Si la valeur true est affectée à cette propriété, les propriétés de sécurité sont sauvegardées sur l'hôte et utilisées pour les soumissions de travaux suivantes sur cet hôte.
Paramètres facultatifs
- -imDataLocations
- Entrez le chemin complet de l'emplacement des données Installation Manager. Vous pouvez entrer plusieurs chemins séparés par des points-virgules. Cette propriété est utile si vous avez des emplacements de données Installation Manager autres que ceux par défaut sur vos cibles. Par exemple, si vous avez spécifié des emplacements de données lors de l'installation d'Installation Manager, le travail d'inventaire de CIM peut ne pas trouver les emplacements de données autres que ceux par défaut. De ce fait, vous pouvez avoir besoin de spécifier des emplacements de données supplémentaires lors de l'enregistrement d'un hôte.
Si un emplacement de données non valide est indiqué, il ne sera pas sauvegardé. Si l'emplacement de données spécifié peut être détecté par le travail d'inventaire, il sera sauvegardé. Vous pouvez également utiliser le travail de localisation de données pour rechercher des emplacements de données sur le système. Le travail de localisation de données met automatiquement à jour cette propriété. Par exemple :
AdminTask.registerHost('[-host hostname -hostProps [ [imDataLocations datalocation1; datalocation2] [password ****] [saveSecurity true] [username username] ]]')
AdminTask.registerHost('-host hostname -hostProps [ [username admin][password password][saveSecurity true]
[WLP_WORKING_DIR C:/working][WLP_SHARED_DIR C:/shared][WLP_ADDITIONAL_DIRS C:/addl] ]')
Valeur renvoyée
Cette commande renvoie un inventaire de l'hôte distant.
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.registerHost('-host myHost.acme.com -hostProps [ [osType linux][username root] [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true] ]')
- Avec la liste Jython :
AdminTask.registerHost('-host', 'myHost.acme.com', '-hostProps', '[ [osType linux] [username root] [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true]' ]')
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.registerHost('-interactive')
unregisterHost
La commande unregisterHost supprime l'hôte distant du gestionnaire de travaux. Utilisez la commande unregisterHost pour désenregistrer une cible d'hôte distant du gestionnaire de travaux. Une fois que l'hôte est désenregistré, le gestionnaire de travaux ne peut plus exécuter de travaux sur la cible.
Objet cible
Aucun.
Paramètres requis
- -host
- Indique le nom de l'ordinateur distant à désenregistrer du gestionnaire des travaux. (Chaîne, obligatoire)
Paramètres facultatifs
Aucun
Valeur renvoyée
Aucun
Syntaxe d'un exemple de mode différé
- Avec une chaîne Jython :
AdminTask.unregisterHost('-host myHost.acme.com')
- Avec la liste Jython :
AdminTask.unregisterHost('-host', 'myHost.acme.com')
Exemple d'utilisation en mode interactif
- En langage Jython :
AdminTask.unregisterHost('-interactive')