Commandes de l'objet AdminTask en utilisant les outils de script wsadmin
Utilisez l'objet AdminTask pour exécuter des commandes d'administration à l'aide de l'outil wsadmin.
Les commandes d'administration sont chargées dynamiquement lorsque vous démarrez l'utilitaire wsadmin. Les commandes d'administration auxquelles vous avez accès, ainsi que les opérations que vous pouvez exécuter avec elles, dépendent de l'édition du produit que vous utilisez.
Vous pouvez démarrer le client de scriptage sans exécuter de serveur en utilisant l'option -conntype NONE avec l'outil wsadmin. Les commandes d'administration AdminTask sont disponibles à la fois dans le mode connecté et le mode local. Si un serveur est en cours d'exécution, il n'est pas recommandé de lancer le commandes AdminTask en mode local car les modifications apportées à la configuration ne sont pas reflétées dans la configuration du serveur en cours d'exécution et vice versa. Si vous sauvegardez des modifications non compatibles, la configuration risque d'être endommagée.
Dans l'environnement d'un gestionnaire de déploiement, les mises à jour de la configuration sont uniquement disponibles lorsqu'un client de scriptage est connecté à un gestionnaire de déploiement. Lorsque le client de scriptage est connecté à un agent de noeud ou à un serveur d'applications géré, vous ne pouvez pas mettre à jour la configuration de ces processus de serveur car il s'agit d'une copie de la configuration maîtresse qui réside sur le gestionnaire de déploiement. Cette copie est créée sur une machine noeud lorsqu'une synchronisation de la configuration du gestionnaire de déploiement et de l'agent de noeud a lieu. Pour modifier la configuration des processus de serveur, vous devez connecter un client de scriptage à un gestionnaire de déploiement. Pour modifier une configuration, n'exécutez pas un client de scriptage en mode local sur une machine noeud car il n'est pas pris en charge.
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
createTCPEndPoint
La commande createTCPEndPoint crée un nouveau noeud final que vous pouvez associer à un canal TCP en entrée.
Objet cible
L'instance parent de TransportChannelService contenant TCPInboundChannel. (ObjectName, obligatoire)Paramètres obligatoires
- -name
- Indique le nom du nouveau noeud final. (Chaîne, obligatoire)
- -host
- Indique l'hôte du nouveau noeud final. (Chaîne, obligatoire)
- -port
- Indique le port du nouveau noeud final. (Chaîne, obligatoire)
Paramètres facultatifs
Aucun.Exemple de sortie
La commande renvoie le nom d'objet du noeud final créé.Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask createTCPEndPoint (cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1) {-name Nom_Noeud_Final_Exemple -host MaGénération.emplacement.ibm.com -port 8978}
- Avec
la chaîne Jython :
AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', '[-name Nom_Noeud_Final_Exemple -host MaGénération.emplacement.ibm.com -port 8978]')
- A l'aide de la liste Jython :
AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', ['-name', 'Nom_Noeud_Final_Exemple', '-host', 'MaGénération.emplacement.ibm.com', '-port', '8978'])
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask createTCPEndPoint {-interactive}
- Avec Jython :
AdminTask.createTCPEndPoint('-interactive')
getTCPEndPoint
La commande getTCPEndPoint obtient le noeud final indiqué associé à un canal TCP en entrée ou à une chaîne contenant un canal TCP en entrée.
Objet cible
Instance TCPInboundChannel, ou chaîne le contenant, associée à un élément NamedEndPoint. (ObjectName, obligatoire)Paramètres obligatoires
Aucun.Paramètres facultatifs
Aucun.Exemple de sortie
La commande renvoie le nom d'objet d'un noeud final nommé existant associé à l'instance de canal entrant TCP ou à une chaîne de canaux.Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask getTCPEndPoint TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)
$AdminTask getTCPEndPoint DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)
- Avec
la chaîne Jython :
print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)')
print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)')
- A l'aide de la liste Jython :
print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)')
print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)')
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask getTCPEndPoint {-interactive}
- En langage
Jython :
print AdminTask.getTCPEndPoint('-interactive')
help
La commande help présente un résumé des commandes d'aide et la syntaxe des commandes d'administration. Vous pouvez utiliser les caractères génériques (*) ou les expressions Java régulières (.*) dans la syntaxe de commande pour personnaliser la requête de recherche.
Objet cible
Aucun.Paramètres facultatifs
- -commands
- La commande help fournit une liste de commandes d'administration disponibles si vous utilisez le paramètre -commands. (Chaîne, optionnelle)
- -commandGroups
- La commande help fournit liste de groupes de commandes d'administration si vous utilisez le paramètre -commandGroups. (Chaîne, optionnelle)
- -commandName
- La commande help fournit des informations d'aide pour une commande d'administration donnée. (Chaîne, optionnelle)
- -stepName
- La commande help fournit des informations d'aide pour une étape donnée d'une commande d'administration. (Chaîne, optionnelle)
Exemple de sortie
La commande renvoie des informations de commande générales de l'objet AdminTask.Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask help
- En langage
Jython :
print AdminTask.help()
- A l'aide de Jacl :
$AdminTask help -commands
- En langage
Jython :
print AdminTask.help('-commands')
- A l'aide de Jacl :
$AdminTask help createJ2CConnectionFactory
- En langage
Jython :
print AdminTask.help('createJ2CConnectionFactory')
- A l'aide de Jacl :
$AdminTask help -commands *create*
- En langage
Jython :
print AdminTask.help('-commands *create*')
- A l'aide de Jacl :
$AdminTask help -commands <pattern>
- En langage
Jython :
print AdminTask.help('-commands <pattern>')
listTCPEndPoints
La commande listTCPEndPoints recense tous les noeuds finaux nommés pouvant être associés à un canal TCP en entrée.
Objet cible
Instance de canal entrant TCP pour laquelle les candidats des noeuds finaux nommés sont répertoriés. (ObjectName, obligatoire)Paramètres obligatoires
Aucun.Paramètres facultatifs
- -excludeDistinguished
- Indique si seuls les noeuds finaux nommés non distinctifs doivent ou non être affichés. Il n'est pas nécessaire d'indiquer une valeur pour ce paramètre. (Booléen, facultatif)
- -unusedOnly
- Indique si les noeuds finaux nommés non utilisés par d'autres instances de canal entrant TCP doivent ou non être associés. Il n'est pas nécessaire d'indiquer une valeur pour ce paramètre. (Booléen, facultatif)
Exemple de sortie
La commande renvoie la liste des noms d'objet des noeuds finaux nommés admissibles.Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1) {-excludeDistinguished}
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1) {-excludeDistinguished -unusedOnly}
- Avec
la chaîne Jython :
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished]')
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished]')
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished -unusedOnly]')
- A l'aide de la liste Jython :
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished'])
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished'])
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished', '-unusedOnly'])
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask listTCPEndPoints {-interactive}
- En langage
Jython :
print AdminTask.listTCPEndPoints('-interactive')
listTCPThreadPools
La commande listTCPThreadPools recense tous les pools d'unités d'exécution pouvant être associés à un canal TCP en entrée ou à un canal TCP en sortie.
Objet cible
L'instance TCPInboundChannel ou TCPOutboundChannel pour laquelle les ThreadPool candidats sont répertoriés. (ObjectName, obligatoire)Paramètres obligatoires
Aucun.Paramètres optionnels
Aucun.Exemple de sortie
La commande renvoie la liste des noms d'objet des groupes d'unités d'exécution admissibles.Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask listTCPThreadPools TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
- Avec
la chaîne Jython :
print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
- A l'aide de la liste Jython :
print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask listTCPThreadPools {-interactive}
- En langage
Jython :
print AdminTask.listTCPThreadPools('-interactive')
updateAppOnCluster
La commande updateAppOnCluster permet de synchroniser des noeuds et de redémarrer des membres de cluster en vue de mettre à jour une application déployée sur un cluster. Après la mise à jour de l'application, cette commande permet de synchroniser les noeuds sans arrêter simultanément tous les membres de cluster sur tous les noeuds. Cette commande synchronise un noeud à la fois. Pour synchroniser un noeud, les membres de cluster ciblés par l'application sont d'abord arrêtés, puis une opération de synchronisation de noeuds est exécutée et les membres du cluster sont relancés.
Cette commande peut dépasser le délai d'expiration par défaut du connecteur ; cela dépend du nombre de noeuds couverts par le cluster cible. Veillez à définir des valeurs de délai d'expiration adéquates dans le fichier soap.client.props (répertoire racine_profil/properties), sas.client.props ou ipc.client.props, selon que vous utilisez, respectivement, un connecteur SOAP, JSR160RMI ou IPC.
Cette commande n'est pas prise en charge en mode local.
Objet cible
Aucun.Paramètres obligatoires
- -ApplicationNames
- Indique les noms des applications mises à jour. (Chaîne, obligatoire)
Paramètres optionnels
- -timeout
- Indique le délai d'expiration (en secondes) de chaque synchronisation de noeud. La valeur par défaut est 300 secondes. (Entier, facultatif).
Exemple de sortie
La commande ne renvoie pas de sortie.Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask updateAppOnCluster {-ApplicationNames app1}
$AdminTask updateAppOnCluster {-ApplicationNames app1 -timeout 600}
- Avec
la chaîne Jython :
AdminTask.updateAppOnCluster('[-ApplicationNames app1]')
AdminTask.updateAppOnCluster('[-ApplicationNames app1 -timeout 600]')
- A l'aide de la liste Jython :
AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1'])
AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1', '-timeout', '600'])
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask updateAppOnCluster -interactive
- En langage
Jython :
AdminTask.updateAppOnCluster('-interactive')