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

Intelligent Management: tareas administrativas de gestión de edición de aplicación

Puede utilizar los lenguajes de script Jacl o Jython para gestionar ediciones de aplicaciones. También puede utilizar el objeto AdminApp para gestionar aplicaciones con ediciones específicas.

Utilice los siguientes mandatos para activar, desactivar, realizar un despliegue, validar, listar y verificar una edición de aplicación. También puede clonar un clúster dinámico existente para utilizar un grupo de nodos distinto y cancelar la modalidad de validación de una edición de aplicación:
Puede realizar las siguientes operaciones utilizando el objeto AdminApp en wsadmin para gestionar aplicaciones con ediciones: Para obtener una lista completa de operaciones que puede realizar utilizando el objeto AdminApp, consulte el tema sobre mandatos del objeto AdminApp con scripts wsadmin.

activateEdition

El mandato activateEdition activa una edición.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el nombre de la edición de la aplicación. (Serie)

Valor de retorno

El mandato devuelve:
  • true: ha tenido éxito
  • false: ha fallado

Ejemplo de uso de la modalidad de proceso por lotes

  • En Jacl:
    $AdminTask activateEdition {-appName BeenThere -edition 1.0}  
  • Utilizando la serie Jython:
    AdminTask.activateEdition ('[-appName BeenThere -edition 1.0]')  
  • Utilizando la lista Jython:
    AdminTask.activateEdition (['-appName', 'BeenThere', '-edition', '1.0'])

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask activateEdition {-interactive}  
  • Utilizando la serie Jython:
    AdminTask.activateEdition ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.activateEdition (['-interactive'])

deactivateEdition

El mandato deactivateEdition desactiva una edición.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el nombre de la edición de la aplicación. (Serie)

Valor de retorno

El mandato devuelve:
  • true: ha tenido éxito
  • false: ha fallado

Ejemplo de uso de la modalidad de proceso por lotes

  • En Jacl:
    $AdminTask deactivateEdition {-appName BeenThere -edition 1.0}  
    Utilizando la serie Jython:
    AdminTask.deactivateEdition ('[-appName BeenThere -edition 1.0]')
  • Utilizando la lista Jython:
    AdminTask.deactivateEdition (['-appName', 'BeenThere', '-edition', '1.0'])

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask deactivateEdition {-interactive}  
    Utilizando la serie Jython:
    AdminTask.deactivateEdition ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.deactivateEdition (['-interactive'])

rolloutEdition

El mandato rolloutEdition despliega una edición y especifica el tamaño de grupo.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el valor de la propiedad personalizada. (Serie)
-params
Especifica valores de configuración para el despliegue. (Serie)
rollout strategy
  • grouped: Activa la aplicación especificada en lugar de la edición actual de la misma aplicación en el clúster en el que se despliega el clúster de aplicaciones, N servidores a la vez, tal como se especifica mediante la palabra clave groupSize. El tamaño de grupo por omisión es 1. Durante el despliegue, las dos ediciones de la aplicación pueden atender solicitudes. Establezca siempre el número de grupo de forma que sea como mínimo una unidad inferior al tamaño del clúster de modo que al menos un miembro de clúster atienda a la edición anterior mientras se inicia el despliegue de la nueva edición.
  • atomic: Activa la aplicación especificada en lugar de la edición actual de la misma aplicación en el clúster en el que se despliega el clúster de aplicaciones, en mitad del clúster en un instante de tiempo, de modo que la única edición de la aplicación atiende solicitudes en cualquier momento dado.
estrategia de restablecimiento
Especifica cómo iniciar una instancia de edición de aplicación durante la operación de despliegue.
  • hard: detiene o reinicia el servidor de aplicaciones.
  • soft: detiene o reinicia la instancia de aplicación, a la vez que deja el servidor de aplicaciones ejecutándose.
tamaño de grupo para el despliegue de grupo
Especifica el número de servidores que se van a actualizar cuando se agrupa la rolloutStrategy.
  • Entero
intervalo de drenaje
Especifica el número de segundos que se van a esperar antes de detener una instancia de edición de aplicación durante el despliegue tal que puedan finalizarse esas sesiones. El valor predeterminado es de 30 segundos.
  • Entero
Especifique las propiedades siguientes para el despliegue de aplicaciones SIP (Session Initiation Protocol):
quiesce strategy
Especifica si los miembros de clúster y servidores se inmovilizan después de que finalizan todos los diálogos y sesiones activos o si se inmovilizan los miembros y servidores del clúster después de un intervalo especificado.

DEFAULT (VALOR PREDETERMINADO): Los miembros y los servidores del clúster se inmovilizan cuando finalizan las sesiones y los diálogos activos.

INTERVAL: Los miembros y los servidores del clúster se inmovilizan después de un intervalo especificado. También debe especificar el valor de quiesceInterval (intervalo de inmovilización) como un entero en segundos.

Valor de retorno

El mandato devuelve:
  • true: ha tenido éxito
  • false: ha fallado

Ejemplo de uso de la modalidad de proceso por lotes

  • Utilizando Jacl:
    $AdminTask rolloutEdition {-appName BeenThere -edition 1.0 -params
    “{quiesceStrategy INTERVAL}{quiesceInterval 30}”}  
    Utilizando la serie Jython:
    AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params
    “{quiesceStrategy INTERVAL}{quiesceInterval 30}”]')  
    Avoid trouble Avoid trouble: El ejemplo siguiente sólo se aplica a la versión 6.1.0.5 que se ejecuta con WebSphere Application Server Network Deployment versión 7.0.0.x.gotcha
    AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params
    [[rolloutStrategy grouped][resetStrategy soft]
    [groupSize 1][drainageInterval 30]]]')
  • Utilizando la lista Jython:
    AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params',
    '{quiesceStrategy INTERVAL}{quiesceInterval 30}']) 
    Avoid trouble Avoid trouble: El ejemplo siguiente sólo se aplica a la versión 6.1.0.5 que se ejecuta con WebSphere Application Server Network Deployment versión 7.0.0.x.gotcha
    AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params',
    '[[rolloutStrategy grouped][resetStrategy soft]
    [groupSize 1][drainageInterval 30]]'])

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask rolloutEdition {-interactive}  
    Utilizando la serie Jython:
    AdminTask.rolloutEdition ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.rolloutEdition (['-interactive'])

validateEdition

El mandato validateEdition valida una edición.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el nombre de la edición de la aplicación. (Serie)
-params
Especifica los valores del clúster clonado creado durante la validación.
Nota: Para los clústeres dinámicos, se utiliza el tamaño del clúster original para el clúster clonado.
  • Clúster dinámico:
    dynClusterMaxSize
    Especifica el número máximo de instancias de clúster dinámico que se iniciarán.
    dynClusterMinSize
    Especifica el número mínimo de instancias de clúster dinámico que se iniciarán.
  • Clúster estático:
    staticClusterSize
    Especifica el tamaño del clúster estático. El valor de staticClusterSize no puede superar el tamaño del clúster estático que se está clonando.

Valor de retorno

El mandato devuelve:
  • true: ha tenido éxito
  • false: ha fallado

Ejemplo de uso de la modalidad de proceso por lotes

  • Utilizando Jacl:
    $AdminTask validateEdition {-appName BeenThere -edition 1.0 -params
    “{dynClusterMaxSize 2}{dynClusterMinSize 1}”}    
    Utilizando la serie Jython:
    AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params
    “{dynClusterMaxSize 2}{dynClusterMinSize 1}”]')
    Avoid trouble Avoid trouble: El ejemplo siguiente sólo se aplica a la versión 6.1.0.5 que se ejecuta con WebSphere Application Server Network Deployment versión 7.0.0.x.gotcha
    AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params
    [[dynClusterMaxSize 2][dynClusterMinSize 1]]]')
  • Utilizando la lista Jython:
    AdminTask.validateEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params',
    '{dynClusterMaxSize 2}{dynClusterMinSize 1}'])  
    Avoid trouble Avoid trouble: El ejemplo siguiente sólo se aplica a la versión 6.1.0.5 que se ejecuta con WebSphere Application Server Network Deployment versión 7.0.0.x.gotcha
    AdminTask.validateEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params',
    '[[dynClusterMaxSize 2][dynClusterMinSize 1]]'])  

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask validateEdition {-interactive}  
    Utilizando la serie Jython:
    AdminTask.validateEdition ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.validateEdition (['-interactive'])

listEditions

El mandato listEditions proporciona una lista de todas las ediciones instaladas de la aplicación.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)

Valor de retorno

El mandato devuelve una matriz de serie de todas las ediciones instaladas de la aplicación.
Nota: El valor de retorno para las ediciones base se visualiza como "".

Ejemplo de uso de la modalidad de proceso por lotes

  • En Jacl:
    $AdminTask listEditions {-appName HelloWorld}   
    Utilizando la serie Jython:
    AdminTask.listEditions ('[-appName HelloWorld]')
  • Utilizando la lista Jython:
    AdminTask.listEditions (['-appName', 'HelloWorld']) 

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask listEditions {-interactive}  
    Utilizando la serie Jython:
    AdminTask.listEditions ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.listEditions (['-interactive'])

isEditionExists

El mandato isEditionExists comprueba que la edición especificada existe para la aplicación concreta.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el nombre de la edición de la aplicación. (Serie)

Valor de retorno

El mandato devuelve:
  • true: ha tenido éxito
  • false: ha fallado

Ejemplo de uso de la modalidad de proceso por lotes

  • Utilizando Jacl:
    $AdminTask isEditionExists {-appName HelloWorld -edition 2.0}   
    Utilizando la serie Jython:
    AdminTask.isEditionExists ('[-appName HelloWorld -edition 2.0]')
  • Utilizando la lista Jython:
    AdminTask.isEditionExists (['-appName', 'HelloWorld', '-edition', '2.0']) 

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask isEditionExists {-interactive}  
    Utilizando la serie Jython:
    AdminTask.isEditionExists ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.isEditionExists (['-interactive'])

cloneDynamicCluster

El mandato cloneDynamicCluster clona un clúster dinámico para utilizar un grupo de nodos diferente.

Objeto de destino

Ninguno.

Parámetros

-clusterName
Especifica el nombre del clúster dinámico original. (Serie)
-newClusterName
Especifica el nombre del clúster dinámico clonado. (Serie)
-nodeGroupName
Especifica el nombre del grupo de nodos en el que se encuentra el clúster dinámico clonado. De forma predeterminada, el nombre se establece en el grupo de nodos actual si no se especifica este parámetro. (Serie)
-opMode
Especifica la modalidad operativa del clúster dinámico clonado. De forma predeterminada, se utiliza la modalidad del clúster dinámico original si este parámetro no se especifica. Establezca el valor en automático, manual o supervisado. (Serie)

Para obtener más información sobre modalidades operativas, consulte el tema sobre clústeres dinámicos.

-templateName
Especifica el nombre de una plantilla existente en el formato de nombre_célula/nombre_nodo/nombre_servidor. La plantilla se utiliza para crear las instancias de servidor del clúster clonado.

Ejemplo de uso de la modalidad de proceso por lotes

  • Utilizando 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}   
    Utilizando la serie 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]')
  • Utilizando la lista 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']) 

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask cloneDynamicCluster {-interactive}  
  • Utilizando la serie Jython:
    AdminTask.cloneDynamicCluster ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.cloneDynamicCluster (['-interactive'])
    
    

cancelValidation

El mandato cancelValidation cancela la modalidad de validación en una edición de aplicación.

El mandato getEditionState devuelve el estado de la edición de aplicación. El estado de una edición existente puede ser ACTIVO, INACTIVO o VALIDAR. Para la edición o la aplicación no existente, el método devuelve un valor nulo.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el nombre de la edición de la aplicación. (Serie)

Valor de retorno

El mandato devuelve:
  • true: la cancelación de la validación se ha realizado satisfactoriamente.
  • false: la cancelación de la validación ha sido anómala.

Ejemplo de uso de la modalidad de proceso por lotes

  • Utilizando Jacl:
    $AdminTask cancelValidation {-appName BeenThere -edition 1.0}  
  • Utilizando la serie Jython:
    AdminTask.cancelValidation ('[-appName BeenThere -edition 1.0]') 
  • Utilizando la lista Jython:
    AdminTask.cancelValidation (['-appName', 'BeenThere', '-edition', '1.0']) 

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask cancelValidation {-interactive}  
  • Utilizando la serie Jython:
    AdminTask.cancelValidation ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.cancelValidation (['-interactive'])

getEditionState

El mandato getEditionState devuelve el estado de edición de la aplicación. El estado de una edición existente puede ser ACTIVO, INACTIVO o VALIDAR. Para una edición o aplicación no existente, el método devuelve un valor nulo.

Objeto de destino

Ninguno.

Parámetros

-appName
Especifica el nombre de la aplicación. (Serie)
-edition
Especifica el nombre de la edición de la aplicación. (Serie)

Valor de retorno

El mandato devuelve:
  • ACTIVE
  • INACTIVE
  • VALIDATE

Ejemplo de uso de la modalidad de proceso por lotes

  • Utilizando Jacl:
    $AdminTask getEditionState {-appName BeenThere -edition 1.0}  
  • Utilizando la serie Jython:
    AdminTask.getEditionState ('[-appName BeenThere -edition 1.0]') 
  • Utilizando la lista Jython:
    AdminTask.getEditionState (['-appName', 'BeenThere', '-edition', '1.0']) 

Ejemplo de utilización de la modalidad interactiva

  • En Jacl:
    $AdminTask getEditionState {-interactive}  
  • Utilizando la serie Jython:
    AdminTask.getEditionState ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.getEditionState (['-interactive'])

Instalar una aplicación con una edición

Utilice el mandato AdminApp install para instalar una aplicación con una edición. Debe pasar el parámetro -edition para especificar el identificador de edición.

Puede utilizar el siguiente ejemplo en wsadmin para instalar la aplicación BeenThere con la edición 1.0.
  • Utilizando 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}}}  
  • En 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]]]') 

Actualizar una aplicación con una edición

Utilice el mandato AdminApp update para actualizar una aplicación con una edición. Pase el nombre de aplicación completo, que es el nombre de la aplicación y la edición, para especificar la edición.

Puede utilizar el siguiente ejemplo para actualizar la edición 1.0 de la aplicación BeenThere con el archivo BeenThereE1-update.ear.
  • Utilizando 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}  
  • En 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]') 

Editar una aplicación con una edición

Utilice el mandato AdminApp edit para editar una aplicación con una edición. Pase el nombre de aplicación completo, que es el nombre de la aplicación y la edición, para especificar la edición.

Puede utilizar el siguiente ejemplo en wsadmin para editar la edición 1.0 de la aplicación BeenThere cambiando la raíz de contexto del módulo web por /beenthere.
  • Utilizando Jacl:
    $AdminApp edit BeenThere-edition1.0 {-CtxRootForWebMod {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere}}} 
  • En Jython:
    AdminApp.edit('BeenThere-edition1.0', '[-CtxRootForWebMod [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere]]]')

Desinstalar una aplicación con una edición

Utilice el mandato AdminApp uninstall para desinstalar una aplicación con una edición. Pase el nombre de aplicación completo, que es el nombre de la aplicación y la edición, para especificar la edición.

Puede utilizar el siguiente ejemplo en wsadmin para desinstalar la edición 1.0 de la aplicación BeenThere.
  • En Jacl:
    $AdminApp uninstall BeenThere-edition1.0 
  • En Jython:
    AdminApp.uninstall('BeenThere-edition1.0')

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_adtaskapped
File name: rwve_adtaskapped.html