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.

Remarque sur la configuration : Pour le langage de script, la commande subst vous permet de remplacer une valeur déjà définie par une variable. Exemple :
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
Les commandes suivantes sont disponibles de l'objet AdminTask mais n'appartiennent pas à un groupe :

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é :

Les exemples de commande suivants renvoient les informations d'aide générale sur l'objet AdminTask :
  • A l'aide de Jacl :
    $AdminTask help
  • En langage Jython :
    print AdminTask.help()
Les exemples de commande suivants affichent chaque commande de l'objet AdminTask :
  • A l'aide de Jacl :
    $AdminTask help -commands
  • En langage Jython :
    print AdminTask.help('-commands')
Les exemples de commande suivants renvoient des informations détaillées pour la commande createJ2CConnectionFactory pour l'objet AdminTask :
  • A l'aide de Jacl :
    $AdminTask help createJ2CConnectionFactory
  • En langage Jython :
    print AdminTask.help('createJ2CConnectionFactory')
Les exemples suivants illustrent l'utilisation du caractère générique (*) pour renvoyer chaque commande contenant la chaîne create :
  • A l'aide de Jacl :
    $AdminTask help -commands *create*
  • En langage Jython :
    print AdminTask.help('-commands *create*')
Les exemples suivants illustrent la syntaxe requise pour utiliser des expressions Java régulières (.*):
  • 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')

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_admintask
Nom du fichier : rxml_admintask.html