![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
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.
activateEdition
El mandato activateEdition activa una edición.
Objeto de destino
Ninguno.
Parámetros
Valor de retorno
- 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
- true: ha tenido éxito
- false: ha fallado
Ejemplo de uso de la modalidad de proceso por lotes
- En Jacl:
Utilizando la serie Jython:
$AdminTask deactivateEdition {-appName BeenThere -edition 1.0}
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:
Utilizando la serie Jython:$AdminTask deactivateEdition {-interactive}
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
- 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
- true: ha tenido éxito
- false: ha fallado
Ejemplo de uso de la modalidad de proceso por lotes
- Utilizando Jacl:
Utilizando la serie 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}”]')
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: 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:
Utilizando la serie Jython:$AdminTask rolloutEdition {-interactive}
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.
- Clúster dinámico:
Valor de retorno
- true: ha tenido éxito
- false: ha fallado
Ejemplo de uso de la modalidad de proceso por lotes
- Utilizando Jacl:
Utilizando la serie 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}”]')
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: 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:
Utilizando la serie Jython:$AdminTask validateEdition {-interactive}
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
Ejemplo de uso de la modalidad de proceso por lotes
- En Jacl:
Utilizando la serie Jython:$AdminTask listEditions {-appName HelloWorld}
AdminTask.listEditions ('[-appName HelloWorld]')
- Utilizando la lista Jython:
AdminTask.listEditions (['-appName', 'HelloWorld'])
Ejemplo de utilización de la modalidad interactiva
- En Jacl:
Utilizando la serie Jython:$AdminTask listEditions {-interactive}
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
- true: ha tenido éxito
- false: ha fallado
Ejemplo de uso de la modalidad de proceso por lotes
- Utilizando Jacl:
Utilizando la serie Jython:$AdminTask isEditionExists {-appName HelloWorld -edition 2.0}
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:
Utilizando la serie Jython:$AdminTask isEditionExists {-interactive}
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}
Utilizando la serie 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]')
- 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
- 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
- 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.
- 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.
- 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.
- 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.
- En Jacl:
$AdminApp uninstall BeenThere-edition1.0
- En Jython:
AdminApp.uninstall('BeenThere-edition1.0')