Gestión de unidades de composición mediante scripts wsadmin
Utilice los mandatos del grupo de mandatos BLAManagement para gestionar las unidades de composición. Utilice los ejemplos de este tema para añadir, eliminar, editar, exportar y ver las unidades de composición.
Antes de empezar
Existen dos procedimientos para completar los ejemplos de esta tarea. Utilice el grupo de mandatos BLAManagement del objeto AdminTask para gestionar las unidades de composición. De manera alternativa, puede utilizar los scripts en la biblioteca de scripts AdminBLA para administrar las configuraciones de unidades de composición.
Acerca de esta tarea
Las unidades de composición pueden representar activos desplegados, otras aplicaciones de nivel empresarial o artefactos externos que se despliegan en entornos de ejecución que no son de WebSphere Application Server sin activos asociados. Las aplicaciones de nivel empresarial contienen cero o más unidades de composición. No puede añadir la misma unidad de composición a más de una aplicación de nivel empresarial, pero puede utilizar un activo para crear más de una unidad de composición.
Procedimiento
- Añada
unidades de composición.
- Inicie la herramienta de scripts wsadmin.
- Añada
unidades de composición. Utilice el mandato addCompUnit para añadir unidades de composición a aplicaciones de nivel empresarial.Nota: Si el activo es un activo de archivado de paquete de empresa (EBA), hay parámetros adicionales que establecer. Para obtener más información, consulte Adición de un activo EBA a una unidad de composición utilizando un mandato addCompUnit.Utilice el siguiente ejemplo de mandato para añadir el activo asset1 como unidad de composición en la aplicación de nivel empresarial miBLA y correlacionar el despliegue con el servidor server1:
AdminTask.addCompUnit('-blaID myBLA cuSourceID asset1 -CUOptions [[.* .* compositionUnit1 "composition unit that is backed by asset1" 0]] -MapTargets [[.* server1]] ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
Utilice el siguiente mandato para añadir el activo asset2 como unidad de composición en la aplicación de nivel empresarial miBLA y correlacionar el despliegue con los servidores server1 y testServer:AdminTask.addCompUnit('-blaID myBLA cuSourceID asset2 -CUOptions [[.* .* compositionUnit2 "composition unit that is backed by asset2" 0]] -MapTargets [[.* server1+testServer]] ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
Utilice el siguiente mandato parta añadir el activo J2EEAsset como unidad de composición a la aplicación de nivel empresarial miBLA y correlacione el despliegue con los servidores server1 y testServer:AdminTask.addCompUnit('[-blaID myBLA cuSourceID J2EEAsset defaultBindingOptions defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host# defaultbinding.force=yes AppDeploymentOptions [-appname defaultapp -installed.ear.destination application_root/myCell/defaultapp.ear] MapModulesToServers [[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1][Increment.jar .* Websphere:cell=cellName,node=nodeName,server=testServer]] -CtxRootForWebMod [[defaultapp.war .* myctx/]]]')
Si edita una unidad de composición para actualizar una biblioteca compartida, primero debe detener manualmente todas las aplicaciones Java EE que dependen de dicha biblioteca compartida. Después de actualizar la biblioteca compartida, reinicie manualmente las aplicaciones Java EE. Las aplicaciones Java EE no se reinician automáticamente cuando una biblioteca compartida se actualiza.
El mandato devuelve los ID de configuración de la unidad de composición y la nueva unidad de composición creada para el activo en la relación de activos, como se muestra en el siguiente ejemplo:WebSphere:cuname=compositionUnit1 WebSphere:cuname=compositionUnit2 WebSphere:cuname=J2EEAsset
- Guarde los cambios de configuración. Utilice el siguiente ejemplo de mandatos para guardar los cambios de configuración:
AdminConfig.save()
- Muestre las unidades de composición y los valores de configuración.
Utilice los mandatos listCompUnits y viewCompUnits para mostrar los ID de configuración de cada unidad de composición que coincide con un ámbito de búsqueda específico.
Puede utilizar el mandato listCompUnits para mostrar cada unidad de composición en la configuración o en una aplicación de nivel empresarial específica. El siguiente ejemplo muestra cada unidad de composición de la aplicación de nivel empresarial miBLA:AdminTask.listCompUnits('-blaID blaname=miBLA')
El mandato devuelve los ID de configuración y el tipo de activo de respaldo de cada unidad de composición que coincide con el ámbito de búsqueda, tal como se muestra en el ejemplo siguiente:Websphere:cuname=cu1 asset Websphere:cuname=cu4 bla WebSphere:cuname=defaultapp __j2ee
Puede utilizar el mandato viewCompUnits para mostrar información de configuración adicional sobre una unidad de composición específica de una aplicación de nivel empresarial. Por ejemplo, el siguiente ejemplo muestra información adicional sobre la unidad de composición cu1 de la aplicación de nivel empresarial miBLA:AdminTask.viewCompUnit('-blaID miBLA -cuID cu1')
El mandato devuelve información de configuración detallada para la unidad de composición, tal como se muestra en el siguiente ejemplo:Especifique las opciones de la unidad de composición (CUOptions) especifique el nombre, las opciones de descripción para la unidad de composición. Parent BLA (parentBLA): [WebSphere:blaname=miBLA] Id de respaldo (backingId): [WebSphere:assetname=asset1.zip] Name (nombre): [cu1] Description (descripción): [mi descripción de la unidad de composición cu1] Peso inicial (startingWeight): [0] Specify servers (MapTargets) Specify targets such as application servers or clusters of application servers where you want to deploy the composition unit contained in the application. Unidad desplegable (deplUnit): [default] *Servers (servidor): [WebSphere:node=myNode,server=server1] Especifique las opciones del plan de activación de la unidad de composición (ActivationPlanOptions) Especifique el nombre de optionsDeployableUnit del plan de activación de la unidad de composición (deplUnit): [Default] Activation Plan (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1]
Si la unidad de composición contiene un activo EBA (enterprise bundle archive), el estado de la unidad de composición también se muestra. Este estado es uno de los valores siguientes:- Utilización del despliegue más reciente de la aplicación OSGi.
- El despliegue de la aplicación OSGi aún no está disponible porque requiere paquetes que continúan bajándose.
- Nuevo despliegue de la aplicación OSGi disponible.
- El nuevo despliegue de la aplicación OSGi no se puede aplicar porque las descargas de paquete han fallado.
- Edite unidades de composición.
- Inicie la herramienta de scripts wsadmin.
- Modifique la unidad de composición. Utilice el mandato editCompUnit para modificar las opciones de la unidad de composición. Puede utilizar este mandato para modificar el peso inicial de la unidad de composición, los destinos de despliegue, las opciones de plan de activación y los valores de relación. Consulte la documentación del grupo de mandatos BLAManagement del objeto AdminTask para ver descripciones de cada una de las opciones que desea modificar.Nota: Si la unidad de composición consta de un activo de archivado de paquete de empresa (EBA), hay parámetros adicionales que puede modificar. Para obtener más información, consulte Modificación de la configuración de una unidad de composición OSGi utilizando el mandato editCompUnit.En el ejemplo siguiente, se edita una unidad de composición asociada a un activo y se sustituye el destino de despliegue:
AdminTask.editCompUnit('-blaID myBLA cuID cu1 CUOptions [[.* .* cu1 cudesc 1]] -MapTargets [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
El mandato devuelve el ID de configuración de la unidad de composición que edita el sistema, tal como se muestra en el ejemplo siguiente:WebSphere:cuname=cu1
- Guarde los cambios de configuración. Utilice el siguiente ejemplo de mandatos para guardar los cambios de configuración:
AdminConfig.save()
- Elimine unidades de composición.
- Inicie la herramienta de scripts wsadmin.
- Elimine unidades de composición. Utilice el mandato deleteCompUnit para eliminar una unidad de composición. Ambos parámetros del siguiente mandato aceptan ID de configuración incompletos, siempre que el sistema pueda hacer coincidir la serie con un ID exclusivo:
AdminTask.deleteCompUnit('-blaID myBLA cuID cu1')
El mandato devuelve el ID de configuración de la unidad de composición que suprime el sistema, tal como se muestra en el ejemplo siguiente:WebSphere:cuname=cu1
- Guarde los cambios de configuración. Utilice el siguiente ejemplo de mandatos para guardar los cambios de configuración:
AdminConfig.save()


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7managecu
File name: txml_7managecu.html