![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
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.
activateEdition
La commande activateEdition active une édition.
Objet cible
Aucun.
Paramètres
Valeur renvoyée
- 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
- true : réussite
- false : échec
Exemple d'utilisation en mode de traitement par lots
- A l'aide de Jacl : A l'aide de la chaîne Jython :
$AdminTask deactivateEdition {-appName BeenThere -edition 1.0}
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 :
Avec une chaîne Jython :$AdminTask deactivateEdition {-interactive}
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
- 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
- true : réussite
- false : échec
Exemple d'utilisation en mode de traitement par lots
- A l'aide de Jacl :
Avec une chaîne Jython :$AdminTask rolloutEdition {-appName BeenThere -edition 1.0 -params “{quiesceStrategy INTERVAL}{quiesceInterval 30}”}
AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params “{quiesceStrategy INTERVAL}{quiesceInterval 30}”]')
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: 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 :
Avec une chaîne Jython :$AdminTask rolloutEdition {-interactive}
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é.
- Cluster dynamique :
Valeur renvoyée
- true : réussite
- false : échec
Exemple d'utilisation en mode de traitement par lots
- A l'aide de Jacl :
Avec une chaîne Jython :$AdminTask validateEdition {-appName BeenThere -edition 1.0 -params “{dynClusterMaxSize 2}{dynClusterMinSize 1}”}
AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params “{dynClusterMaxSize 2}{dynClusterMinSize 1}”]')
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: 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 :
Avec une chaîne Jython :$AdminTask validateEdition {-interactive}
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
Exemple d'utilisation en mode de traitement par lots
- A l'aide de Jacl :
Avec une chaîne Jython :$AdminTask listEditions {-appName HelloWorld}
AdminTask.listEditions ('[-appName HelloWorld]')
- Avec une liste Jython :
AdminTask.listEditions (['-appName', 'HelloWorld'])
Exemple d'utilisation en mode interactif
- A l'aide de Jacl :
Avec une chaîne Jython :$AdminTask listEditions {-interactive}
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
- true : réussite
- false : échec
Exemple d'utilisation en mode de traitement par lots
- A l'aide de Jacl :
Avec une chaîne Jython :$AdminTask isEditionExists {-appName HelloWorld -edition 2.0}
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 :
Avec une chaîne Jython :$AdminTask isEditionExists {-interactive}
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}
Avec une chaîne Jython :$AdminTask cloneDynamicCluster {-clusterName SourceCluster -newClusterName newCluster -nodeGroupName CloneNodeGroup -opMode supervised –templateName xdCell/xdNode/SourceCluster_member1}
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
- 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
- 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.
- 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.
- 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.
- 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.
- A l'aide de Jacl :
$AdminApp uninstall BeenThere-edition1.0
- Langage Jython :
AdminApp.uninstall('BeenThere-edition1.0')