[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management : tâches d'administration pour la gestion des éditions d'application

Vous pouvez utiliser les langages de script Jacl et Jython pour gérer les éditions d'application. Vous pouvez également utiliser l'objet AdminApp pour gérer des éditions d'applications spécifiques.

Utilisez les commandes suivantes pour activer, désactiver, déployer, valider, afficher et vérifier une édition d'application. Vous pouvez également cloner un cluster dynamique existant pour utiliser un groupe de noeuds différent, et annuler le mode de validation sur une édition d'application :
L'objet AdminApp permet d'effectuer les opérations suivantes dans l'outil wsadmin pour gérer les éditions d'application : Pour une liste complète des opérations que vous pouvez effectuer à l'aide de l'objet AdminApp, consultez les rubriques relatives aux commandes de l'objet AdminApp utilisant le scriptage wsadmin.

activateEdition

La commande activateEdition active une édition.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Spécifie le nom de l'édition d'application. (Chaîne)

Valeur renvoyée

La commande renvoie :
  • true : réussite
  • false : échec

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask activateEdition {-appName BeenThere -edition 1.0}
  • A l'aide de la chaîne Jython :
    AdminTask.activateEdition ('[-appName BeenThere -edition 1.0]')  
  • Avec une liste Jython :
    AdminTask.activateEdition (['-appName', 'BeenThere', '-edition', '1.0'])

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask activateEdition {-interactive} 
  • Avec la chaîne Jython :
    AdminTask.activateEdition ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.activateEdition (['-interactive'])

deactivateEdition

La commande deactivateEdition désactive une édition.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Spécifie le nom de l'édition d'application. (Chaîne)

Valeur renvoyée

La commande renvoie :
  • true : réussite
  • false : échec

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask deactivateEdition {-appName BeenThere -edition 1.0}  
    A l'aide de la chaîne Jython :
    AdminTask.deactivateEdition ('[-appName BeenThere -edition 1.0]')
  • A l'aide de la liste Jython :
    AdminTask.deactivateEdition (['-appName', 'BeenThere', '-edition', '1.0'])

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask deactivateEdition {-interactive}  
    Avec une chaîne Jython :
    AdminTask.deactivateEdition ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.deactivateEdition (['-interactive'])

rolloutEdition

La commande rolloutEdition déploie une édition et spécifie la taille du groupe.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Valeur de la propriété personnalisée. (Chaîne)
-params
Spécifie les valeurs de configuration pour le déploiement. (Chaîne)
rolloutStrategy
  • grouped : Active l'application spécifiée à la place de l'édition en cours de la même application sur le cluster sur lequel le cluster d'application effectue le déploiement, N serveurs simultanément, comme spécifié par le mot clé groupSize. La taille de groupe par défaut est 1. Pendant le déploiement, les deux éditions de l'application peuvent traiter les demandes. Définissez toujours une valeur de groupe inférieure d'une unité au moins à la taille du cluster afin qu'au moins un membre du cluster serve l'édition précédente lorsque le déploiement de la nouvelle édition commence.
  • atomic : active l'application spécifiée à la place de l'édition en cours de la même application sur le cluster sur lequel le cluster d'application effectue le déploiement, par moitié de cluster, de sorte qu'une seule édition de l'application traite toujours les demandes.
resetStrategy
Spécifie comment démarrer une instance d'édition d'application durant l'opération de déploiement.
  • hard : arrête puis redémarre le serveur d'applications.
  • soft : arrête ou redémarre l'instance de l'application, tout en laissant s'exécuter le serveur d'applications.
groupSize
Spécifie le nombre de serveurs à mettre à jour lorsque la valeur de rolloutStrategy est grouped.
  • Entier
drainageInterval
Indique le temps d'attente en secondes avant l'arrêt d'une instance d'édition d'application pendant le déploiement, pour permettre l'achèvement des sessions. La valeur par défaut est de 30 secondes.
  • Entier
Indiquez les propriétés suivantes pour le déploiement d'applications SIP (Session Initiation Protocol) :
quiesceStrategy
Indique si les membres de cluster et les serveurs sont mis au repos une fois tous les dialogues et sessions actifs terminés, ou si les membres de cluster sont mis au repos après un intervalle indiqué.

DEFAULT : Les membres de cluster et les serveurs sont mis au repos lorsque les dialogues et les sessions actifs sont terminés.

INTERVAL : Les membres de cluster et les serveurs sont mis au repos après un intervalle indiqué. Vous devez également entrer le paramètre quiesceInterval sous forme d'entier indiquant des secondes.

Valeur renvoyée

La commande renvoie :
  • true : réussite
  • false : échec

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask rolloutEdition {-appName BeenThere -edition 1.0 -params 
    “{quiesceStrategy INTERVAL}{quiesceInterval 30}”}  
    Avec une chaîne Jython :
    AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params 
    “{quiesceStrategy INTERVAL}{quiesceInterval 30}”]')  
    Eviter les incidents Eviter les incidents: L'exemple suivant s'applique uniquement à la version 6.1.0.5 exécutée avec WebSphere Application Server Network Deployment version 7.0.0.x.gotcha
    AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params 
    [[rolloutStrategy grouped][resetStrategy soft]
    [groupSize 1][drainageInterval 30]]]')
  • A l'aide de la liste Jython :
    AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', 
    '{quiesceStrategy INTERVAL}{quiesceInterval 30}']) 
    Eviter les incidents Eviter les incidents: L'exemple suivant s'applique uniquement à la version 6.1.0.5 exécutée avec WebSphere Application Server Network Deployment version 7.0.0.x.gotcha
    AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', 
    '[[rolloutStrategy grouped][resetStrategy soft]
    [groupSize 1][drainageInterval 30]]'])

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask rolloutEdition {-interactive}  
    Avec une chaîne Jython :
    AdminTask.rolloutEdition ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.rolloutEdition (['-interactive'])

validateEdition

La commande validateEdition valide une édition.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Spécifie le nom de l'édition d'application. (Chaîne)
-params
Indique les paramètres du cluster cloné créé au cours de la validation.
Remarque : Pour des clusters dynamiques, la taille du cluster d'origine est utilisée pour le cluster cloné.
  • Cluster dynamique :
    dynClusterMaxSize
    Indique le nombre maximal d'instances de cluster dynamique qui démarreront.
    dynClusterMinSize
    Indique le nombre miniimal d'instances de cluster dynamique qui démarreront.
  • Cluster statique :
    staticClusterSize
    Indique la taille du cluster statique. La valeur du paramètre staticClusterSize ne peut pas être supérieure à la taille du cluster statique cloné.

Valeur renvoyée

La commande renvoie :
  • true : réussite
  • false : échec

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask validateEdition {-appName BeenThere -edition 1.0 -params 
    “{dynClusterMaxSize 2}{dynClusterMinSize 1}”}   
    Avec une chaîne Jython :
    AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params 
    “{dynClusterMaxSize 2}{dynClusterMinSize 1}”]')
    Eviter les incidents Eviter les incidents: L'exemple suivant s'applique uniquement à la version 6.1.0.5 exécutée avec WebSphere Application Server Network Deployment version 7.0.0.x.gotcha
    AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params 
    [[dynClusterMaxSize 2][dynClusterMinSize 1]]]')
  • A l'aide de la liste Jython :
    AdminTask.validateEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', 
    '{dynClusterMaxSize 2}{dynClusterMinSize 1}']) 
    Eviter les incidents Eviter les incidents: L'exemple suivant s'applique uniquement à la version 6.1.0.5 exécutée avec WebSphere Application Server Network Deployment version 7.0.0.x.gotcha
    AdminTask.validateEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', 
    '[[dynClusterMaxSize 2][dynClusterMinSize 1]]'])  

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask validateEdition {-interactive}  
    Avec une chaîne Jython :
    AdminTask.validateEdition ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.validateEdition (['-interactive'])

listEditions

La commande listEditions fournit la liste de toutes les éditions installées de l'application.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)

Valeur renvoyée

La commande renvoie un tableau de chaînes listant toutes les éditions installées de l'application.
Remarque : Pour les éditions de base, la valeur de retour est affichée sous forme de guillemets ("").

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask listEditions {-appName HelloWorld}  
    Avec une chaîne Jython :
    AdminTask.listEditions ('[-appName HelloWorld]')
  • Avec une liste Jython :
    AdminTask.listEditions (['-appName', 'HelloWorld']) 

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask listEditions {-interactive} 
    Avec une chaîne Jython :
    AdminTask.listEditions ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.listEditions (['-interactive'])

isEditionExists

La commande isEditionExists vérifie que l'édition spécifiée existe pour l'application particulière.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Spécifie le nom de l'édition d'application. (Chaîne)

Valeur renvoyée

La commande renvoie :
  • true : réussite
  • false : échec

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask isEditionExists {-appName HelloWorld -edition 2.0}  
    Avec une chaîne Jython :
    AdminTask.isEditionExists ('[-appName HelloWorld -edition 2.0]')
  • A l'aide de la liste Jython :
    AdminTask.isEditionExists (['-appName', 'HelloWorld', '-edition', '2.0']) 

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask isEditionExists {-interactive}
    Avec une chaîne Jython :
    AdminTask.isEditionExists ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.isEditionExists (['-interactive'])

cloneDynamicCluster

La commande cloneDynamicCluster clone un cluster dynamique afin d'utiliser un groupe de noeuds différent.

Objet cible

Aucun.

Paramètres

-clusterName
Spécifie le nom du cluster dynamique d'origine. (Chaîne)
-newClusterName
Spécifie le nom du cluster dynamique cloné. (Chaîne)
-nodeGroupName
Spécifie le nom du groupe de noeuds dans lequel est situé le cluster dynamique cloné. Si ce paramètre n'est pas spécifié, le nom par défaut est celui du groupe de noeuds en cours. (Chaîne)
-opMode
Indique le mode d'exploitation du cluster dynamique cloné. Si ce paramètre n'est pas spécifié, le mode utilisé par défaut est celui du cluster dynamique d'origine. Indiquez la valeur automatic, manual ou supervised. (Chaîne)

Pour plus d'informations sur les modes d'exploitation, consultez la rubrique relative aux clusters dynamiques.

-templateName
Indique le nom d'un modèle existant au format nom_cellule/nom_noeud/nom_serveur. Ce modèle est utilisé pour créer les instances de serveur du cluster cloné.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask cloneDynamicCluster {-clusterName SourceCluster -newClusterName newCluster -nodeGroupName 
    CloneNodeGroup -opMode supervised}  
    $AdminTask cloneDynamicCluster {-clusterName SourceCluster -newClusterName newCluster -nodeGroupName 
    CloneNodeGroup -opMode supervised –templateName xdCell/xdNode/SourceCluster_member1}   
    Avec une chaîne Jython :
    AdminTask.cloneDynamicCluster ('[-clusterName SourceCluster -newClusterName newCluster -nodeGroupName 
    CloneNodeGroup -opMode supervised]')
    AdminTask.cloneDynamicCluster ('[-clusterName SourceCluster -newClusterName newCluster -nodeGroupName 
    CloneNodeGroup -opMode supervised –templateName xdCell/xdNode/SourceCluster_member1]')
  • Avec une liste Jython :
    AdminTask.cloneDynamicCluster (['-clusterName', 'SourceCluster', '-newClusterName', 'newCluster', '-nodeGroupName', 
    'CloneNodeGroup', '-opMode', 'supervised'])
    AdminTask.cloneDynamicCluster (['-clusterName', 'SourceCluster', '-newClusterName', 'newCluster', '-nodeGroupName', 
    'CloneNodeGroup', '-opMode', 'supervised','–templateName', 'xdCell/xdNode/SourceCluster_member1']) 

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask cloneDynamicCluster {-interactive} 
  • Avec la chaîne Jython :
    AdminTask.cloneDynamicCluster ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.cloneDynamicCluster (['-interactive'])
    
    

cancelValidation

La commande cancelValidation annule le mode de validation sur une édition d'application.

La commande getEditionState renvoie l'état de l'édition d'application. L'état d'une édition existante peut être ACTIVE, INACTIVE ou VALIDATE. Si l'application ou l'édition n'existe pas, la commande renvoie la valeur null.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Spécifie le nom de l'édition d'application. (Chaîne)

Valeur renvoyée

La commande renvoie :
  • true : L'annulation du mode de validation a réussi.
  • false : L'annulation du mode de validation a échoué.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask cancelValidation {-appName BeenThere -edition 1.0} 
  • A l'aide de la chaîne Jython :
    AdminTask.cancelValidation ('[-appName BeenThere -edition 1.0]')
  • Avec une liste Jython :
    AdminTask.cancelValidation (['-appName', 'BeenThere', '-edition', '1.0']) 

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask cancelValidation {-interactive}  
  • Avec la chaîne Jython :
    AdminTask.cancelValidation ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.cancelValidation (['-interactive'])

getEditionState

La commande getEditionState renvoie l'état de l'édition d'application. L'état d'une édition existante peut être ACTIVE, INACTIVE ou VALIDATE. Si l'application ou l'édition n'existe pas, la commande renvoie la valeur null.

Objet cible

Aucun.

Paramètres

-appName
Indique le nom de l'application. (Chaîne)
-edition
Spécifie le nom de l'édition d'application. (Chaîne)

Valeur renvoyée

La commande renvoie :
  • ACTIVE
  • INACTIVE
  • VALIDATE

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de Jacl :
    $AdminTask getEditionState {-appName BeenThere -edition 1.0} 
  • A l'aide de la chaîne Jython :
    AdminTask.getEditionState ('[-appName BeenThere -edition 1.0]') 
  • Avec une liste Jython :
    AdminTask.getEditionState (['-appName', 'BeenThere', '-edition', '1.0']) 

Exemple d'utilisation en mode interactif

  • A l'aide de Jacl :
    $AdminTask getEditionState {-interactive} 
  • Avec la chaîne Jython :
    AdminTask.getEditionState ('[-interactive]')
  • A l'aide de la liste Jython :
    AdminTask.getEditionState (['-interactive'])

Installer une édition d'application

Exécutez la commande AdminApp install pour installer une édition d'application. Vous devez utiliser le paramètre -edition pour spécifier l'ID d'édition.

Vous pouvez utiliser l'exemple suivant dans wsadmin pour installer l'édition 1.0 de l'application BeenThere.
  • A l'aide de Jacl :
    $AdminApp install /tmp/BeenThere1.0.ear {-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp 
    -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall 
    warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude 
    -noallowServiceRemoteInclude -MapModulesToServers {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:
    cell=TestCell,cluster=TestClusterB} {"BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:
    cell=TestCell,cluster=TestClusterB}}}  
  • Langage Jython :
    AdminApp.install("/tmp/BeenThere1.0.ear", '[-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp 
    -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall 
    off -processEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -buildVersion Unknown 
    -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml 
    WebSphere:cell=TestCell,cluster=TestClusterB] ["BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:
    cell=TestCell,cluster=TestClusterB]]]') 

Mettre à jour une édition d'application

Exécutez la commande AdminApp update pour mettre à jour une édition d'application. Pour indiquer l'édition, spécifiez comme paramètre le nom complet de l'application, composé du nom de l'application et de l'édition.

Vous pouvez utiliser l'exemple suivant dans wsadmin pour mettre à jour l'édition 1.0 de l'application BeenThere à l'aide du fichier BeenThereE1-update.ear.
  • A l'aide de Jacl :
    $AdminApp update BeenThere-edition1.0 app {-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs 
    -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall 
    warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude 
    -noallowServiceRemoteInclude}  
  • Langage Jython :
    AdminApp.update('BeenThere-edition1.0', 'app', '[-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs 
    -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall 
    warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude 
    -noallowServiceRemoteInclude]') 

Modifier une édition d'application

Exécutez la commande AdminApp edit pour modifier une édition d'application. Pour indiquer l'édition, spécifiez comme paramètre le nom complet de l'application, composé du nom de l'application et de l'édition.

Vous pouvez utiliser l'exemple suivant dans wsadmin pour modifier l'édition 1.0 de l'application BeenThere en définissant la racine de contexte du module Web sur /beenthere.
  • A l'aide de Jacl :
    $AdminApp edit BeenThere-edition1.0 {-CtxRootForWebMod {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere}}} 
  • Langage Jython :
    AdminApp.edit('BeenThere-edition1.0', '[-CtxRootForWebMod [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere]]]')

Désinstaller une édition d'application

Exécutez la commande AdminApp uninstall pour désinstaller une édition d'application. Pour indiquer l'édition, spécifiez comme paramètre le nom complet de l'application, composé du nom de l'application et de l'édition.

Vous pouvez utiliser l'exemple suivant dans wsadmin pour désinstaller l'édition 1.0 de l'application BeenThere.
  • A l'aide de Jacl :
    $AdminApp uninstall BeenThere-edition1.0 
  • Langage Jython :
    AdminApp.uninstall('BeenThere-edition1.0')

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=rwve_adtaskapped
Nom du fichier : rwve_adtaskapped.html