Grupo de mandatos BLAManagement para el objeto AdminTask con scripts wsadmin
Puede utilizar el lenguaje de script Jython para configurar y administrar aplicaciones de nivel de negocio con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo BLAManagement para crear, editar, exportar, suprimir y consultar aplicaciones de nivel de negocio en su configuración.
Para configurar y administrar las aplicaciones de nivel de negocio, debe utilizar el rol administrativo de configurador.
deleteAsset
El mandato deleteAsset elimina un activo de la configuración de la aplicación de nivel empresarial. Antes de utilizar este mandato, verifique que no existe ninguna unidad de composición asociada con el activo de interés. El mandato falla si el activo está asociado a unidades de composición.
Objeto de destino
Ninguno
Parámetros necesarios
- -assetID
- Especifica el ID de configuración del activo que se debe suprimir. El mandato acepta ID incompletos para el parámetro assetID, siempre y cuando el sistema pueda establecer una correspondencia entre la serie y un activo único. (String, obligatorio)
Parámetros opcionales
- -force
- Especifica si debe forzarse al sistema para que suprima un activo, aun cuando otros activos dependan del mismo. (Boolean, opcional)
Valor de retorno
WebSphere:assetname=activo2.zip
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.deleteAsset('-assetID activo2.zip -force true')
- Utilizando la lista Jython:
AdminTask.deleteAsset(['-assetID', 'activo2.zip', '-force', 'true'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.deleteAsset('-interactive')
editAsset
El mandato editAsset modifica opciones adicionales de configuración de activos. Puede utilizar este mandato para modificar la descripción, el URL de destino, las relaciones entre activos, los permisos de archivos y los valores de validación.
Objeto de destino
Ninguno
Parámetros necesarios
- -assetID
- Especifica el ID de configuración del activo que debe editarse. Este parámetro acepta un ID de configuración incompleto, siempre y cuando el sistema pueda establecer una correlación entre la serie y un ID de activo exclusivo. (String, obligatorio)
Pasos opcionales
- -AssetOptions
- Utilice el paso AssetOptions y los argumentos siguientes para
definir propiedades adicionales para el activo.
- inputAsset (sólo lectura)
- Especifica el paquete de origen del activo.
- name (sólo lectura)
- Especifica el nombre del activo. El valor predeterminado para este argumento es el nombre de archivo del paquete de origen.
- defaultBindingProps (sólo lectura)
- Especifica las propiedades de enlace predeterminadas para el activo. Este argumento sólo se aplica a los activos empresariales. Para los activos que no son empresariales, especifique el carácter de asterisco (*) para la coincidencia de patrón. Para los activos empresariales, especifique el valor .* para establecer el argumento como un valor no vacío.
- descripción
- Especifica una descripción del activo.
- destinationUrl
- Especifica el URL de los binarios de activos que deben desplegarse.
- typeAspect
- Especifica el aspecto del tipo de activo.
- relationship
- Especifica la relación del activo. Utilice el carácter de signo más (+) para añadir activos adicionales a la relación existente. Utilice el carácter del signo de número (#) para suprimir un activo existente de la relación. Para sustituir las relaciones existentes, especifique la misma sintaxis que en el mandato importAsset. Si el activo especificado en la relación no existe para la adición o actualización, el mandato devuelve una excepción.
- filePermission
- Especifica la configuración de los permisos de archivo.
- validate
- Especifica si debe validarse el activo. El valor predeterminado es false. El producto no guarda el valor especificado para su validación. Por consiguiente, si selecciona validar el activo (true) ahora y lo actualiza más adelante, cuando edite el activo debe volver a habilitar este valor para que el producto valide los archivos actualizados.
- -UpdateAppContentVersions
- Para un activo EBA, utilice este paso y los argumentos siguientes para seleccionar versiones de paquete para el activo.
trns : En el paquete de características de WebSphere Application Server Versión 7 para aplicaciones OSGi y Java™ Persistence API 2.0, los cambios en el paquete para el activo se aplican reiniciando la aplicación de nivel empresarial. En la Versión 8.x, estos cambios se aplican actualizando la unidad de composición. El nuevo enfoque de la versión 8.x significa que se pueden aplicar muchos cambios de paquete sin reiniciar la aplicación de nivel de empresa. Para habilitar este nuevo enfoque, el parámetro UpdateAppContentVersionsStep se ha sustituido por el parámetro UpdateAppContentVersions y, en lugar de reiniciar la aplicación de nivel empresarial, debe ejecutar el mandato editCompUnit con el parámetro CompUnitStatusStep.
- nombre_paquete
- Especifica el nombre del paquete.
- versión_actual
- Especifica un número de versión de paquete, como por ejemplo 1.0.0, o NOT_DEPLOYED para paquetes compartidos (es decir, use bundles) que se declaran en el manifiesto de aplicación pero no están desplegados por el entorno de ejecución. Este argumento describe la configuración actual del paquete y no se utiliza para cambiar la configuración.
- preferencia_actualización
- Especifica la nueva preferencia de versión de paquete. Puede ser un número de versión de paquete, como por ejemplo 1.0.0, o NOT_DEPLOYED para paquetes compartidos, o bien NO_PREF si desea que el sistema elija automáticamente una versión de paquete. Si no desea actualizar la versión de un paquete dado, establezca este atributo en el mismo valor que está utilizando para el atributo versión_actual.
- Incluya una entrada (es decir, el nombre_paquete versión_actual y preferencia_actualización) para cada paquete que aparece en el manifiesto de aplicación entre la cabecera de contenido de la aplicación y la cabecera de paquete de uso. Incluya todos los paquetes, tanto si actualiza o no la versión del paquete.
- Especifique la sintaxis del modo siguiente:
AdminTask.editAsset('[ -assetID nombre_activo -UpdateAppContentVersions [ [nombre_paquete_1 versión_actual preferencia_actualización] [nombre_paquete_2 versión_actual preferencia_actualización] [nombre_paquete_3 versión_actual preferencia_actualización] [nombre_paquete_4 versión_actual preferencia_actualización] [nombre_paquete_5 versión_actual preferencia_actualización] ]]')
Valor de retorno
El mandato devuelve el ID de configuración del activo de interés.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.editAsset('-assetID activo3.zip – AssetOptions [[.* activo3.zip * "activo para pruebas" c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]')
- Utilizando la lista Jython:
AdminTask.editAsset(['-assetID', 'asset3.zip', '–AssetOptions', '[[.* asset3.zip * "activo para pruebas" c:/installedAssets/asset3.zip/BASE/asset3.zip "" assetname=a.jar "" false]]'])
- Utilizando la serie Jython:
AdminTask.editAsset('-assetID defaultapp.ear – AssetOptions [[.* defaultapp.ear .* "asset for testing" "" "" "" "" false]]')
- Utilizando la lista Jython:
AdminTask.editAsset(['-assetID', 'defaultapp.ear', '–AssetOptions', '[[.* defaultapp.ear .* "activo para pruebas" "" "" "" "" false]]'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.editAsset('-interactive')
exportAsset
El mandato exportAsset exporta una configuración de activo a un archivo.
Objeto de destino
Ninguno
Parámetros necesarios
- -assetID
- Especifica el ID de configuración del activo que debe exportarse. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, obligatorio)
- -filename
- Especifica el nombre de archivo al que el sistema exporta la configuración del activo. (DownloadFile, obligatorio)
Valor de retorno
El mandato no devuelve ninguna salida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.exportAsset('-assetID asset2.zip – filename c:/temp/a2.zip')
- Utilizando la lista Jython:
AdminTask.exportAsset(['-assetID', 'asset2.zip', '–filename', 'c:/temp/a2.zip'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.exportAsset('-interactive')
importAsset
El mandato importAsset importa una configuración de activo al repositorio de activos. Una vez que se han importado los archivos, pueden añadirse a las aplicaciones de nivel empresarial como unidades de composición.
Objeto de destino
Ninguno
Parámetros necesarios
- -source
- Especifica el nombre del archivo de origen que debe importarse. (UploadFile, obligatorio)
Parámetros opcionales
- -storageType
- Especifica el modo en que el sistema guarda el activo en el repositorio de activos. El repositorio de activos por omisión almacena binarios completos, metadatos de binarios o ningún binario. Especifique FULL para almacenar binarios completos. Especifique METADATA para almacenar la parte de metadatos de los binarios. Especifique NONE para no almacenar binarios en el repositorio. El valor predeterminado es FULL. (String, opcional)
Pasos opcionales
- -AssetOptions
- Utilice el paso AssetOptions y los argumentos siguientes para
definir propiedades adicionales para el activo.
- inputAsset (sólo lectura)
- Especifica el paquete de origen del activo.
- nombre
- Especifica el nombre del activo. El nombre del archivo de extensiones del activo debe coincidir con el nombre del archivo de extensiones del paquete de origen. El valor predeterminado para este argumento es el nombre de archivo del paquete de origen.
- defaultBindingProps (sólo lectura)
- Especifica las propiedades de enlace predeterminadas para el activo. Este argumento sólo se aplica a los activos empresariales. Para los activos que no son empresariales, especifique el carácter de asterisco (*) para la coincidencia de patrón. Para los activos empresariales, especifique el valor .* para establecer el argumento como un valor no vacío.
- descripción
- Especifica una descripción del activo.
- destinationUrl
- Especifica el URL de los binarios de activos que deben desplegarse.
- typeAspect
- Especifica el aspecto del tipo de activo. Especifique la opción typeAspect en el formato de nombre de objeto, como se muestra en la sintaxis siguiente: spec=xxx
- relationship
- Especifica la relación del activo. Utilice el carácter de signo más (+) para especificar varias relaciones de activos. El mandato devuelve una excepción si en la relación se especifican activos que no existen.
- filePermission
- Especifica la configuración de los permisos de archivo.
Las aplicaciones OSGi no utilizan un valor filePermission.
- validate
- Especifica si debe validarse el activo. El valor predeterminado es false.
El producto no guarda el valor especificado para su validación. Por consiguiente, si
selecciona validar el activo (true) ahora y lo actualiza más
adelante, cuando edite el activo debe volver a habilitar este valor para que el
producto valide los archivos actualizados.
Las aplicaciones OSGi no utilizan un valor validate.
Valor de retorno
WebSphere:assetname=activo2.zip
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.importAsset('-source c:\ears\asset1.zip -storageType NONE')
- Utilizando la lista Jython:
AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'NONE'])
- Utilizando la serie Jython:
AdminTask.importAsset('-source c:\ears\asset1.zip -storageType METADATA – AssetOptions [[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
- Utilizando la lista Jython:
AdminTask.importAsset(['-source', 'c:\ears\asset1.zip', '-storageType', 'METADATA', '–AssetOptions', '[[.* asset2.zip .* "asset for testing" c:/installedAssets/asset2.zip/BASE/asset2.zip "" "" "" "" false]]')
- Utilizando la serie Jython:
AdminTask.importAsset('[-source c:\ears\asset3.zip -storageType FULL – AssetOptions [[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]]')
- Utilizando la lista Jython:
AdminTask.importAsset(['-source', 'c:\ears\asset3.zip', '-storageType', 'FULL', '–AssetOptions', '[[.* asset3.zip .* "asset for testing" "" spec=zip assetname=a.jar+assetname=b.jar "" false]]'])
- Utilizando la serie Jython:
AdminTask.importAsset('-source c:\ears\defaultapplication.ear – storageType FULL – AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" false]]')
- Utilizando la lista Jython:
AdminTask.importAsset(['-source', 'c:\ears\defaultapplication.ear', '–storageType', 'FULL', '–AssetOptions', '[[.* defaultapp.ear .* "desc" "" "" "" false]]'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.importAsset('-interactive')
listAssets
El mandato listAssets muestra el ID de configuración de cada activo dentro de la célula.
Objeto de destino
Ninguno
Parámetros opcionales
- -assetID
- Especifica el ID de configuración del activo de interés. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, opcional)
- -includeDescription
- Especifica si debe incluirse una descripción de cada uno de los activos que devuelve el mandato. Especifique true para visualizar las descripciones de los activos. (String, opcional)
- -includeDeplUnit
- Especifica si deben visualizarse unidades desplegables para cada uno de los activos que devuelve el mandato. Especifique true para visualizar unidades desplegables. (String, opcional)
Valor de retorno
WebSphere:assetname=asset1.zip
"activo para pruebas"
WebSphere:assetname=asset2.zip
"segundo activo para pruebas"
a.jar
WebSphere:aasetname=asset3.zip
"tercer activo para pruebas"
a1.jar+a2.jar
WebSphere:assetname=a.jar0
"a.jar para sharedlib"
WebSphere:assetname=b.jar
"b.jar para sharedlib"
WebSphere:assetname=defaultapp.ear
"aplic. predeterminada"
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando Jython:
AdminTask.listAssets()
- Utilizando la serie Jython:
AdminTask.listAssets('-assetID asset1.zip')
- Utilizando la lista Jython:
AdminTask.listAssets(['-assetID asset1.zip'])
- Utilizando la serie Jython:
AdminTask.listAssets('-includeDescription true – includeDeplUnit true')
- Utilizando la lista Jython:
AdminTask.listAssets(['-includeDescription', 'true', '–includeDeplUnit', 'true')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.listAssets('-interactive')
updateAsset
El mandato updateAsset modifica uno o varios archivos o archivos de módulo de un activo. El mandato actualiza el archivo binario del activo, pero no actualiza las unidades de composición que el sistema despliega con el activo como objeto de respaldo.
Objeto de destino
Ninguno
Parámetros necesarios
- -assetID
- Especifica el ID de configuración del activo que debe actualizarse. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, obligatorio)
- -operation
- Especifica la operación que debe invocarse en el activo ce interés. (String, obligatorio)
- La tabla siguiente muestra las operaciones que se pueden invocar
en el activo:
Tabla 1. Operaciones admitidas de updateAsset. Especifique una de las operaciones. Operación Descripción replace La operación replace sustituye el contenido del activo de interés. merge La operación merge actualiza varios archivos del activo, pero no los actualiza todos. add La operación add añade un archivo o un archivo de módulo nuevo. addupdate La operación addupdate añade o actualiza un archivo o un archivo de módulo. Si el archivo no existe, el sistema añade el contenido. Si el archivo existe, el sistema lo actualiza. update La operación update actualiza un archivo o un archivo de módulo. delete La operación delete suprime un archivo o un archivo de módulo. - -contents
- Especifica el archivo que contiene el contenido que debe añadirse o actualizarse. Este parámetro no es obligatorio para la operación delete. (UploadFile, opcional)
Parámetros opcionales
- -contenturi
- Especifica el URI (Uniform Resource Identifier) del archivo que debe añadirse, actualizarse o eliminarse del activo. Este parámetro no es obligatorio para las operaciones merge o replace. (String, opcional)
Pasos opcionales
- -AssetOptions
- Utilice el paso AssetOptions y los argumentos siguientes para
definir propiedades adicionales para el activo.
- name (sólo lectura)
- Especifica el nombre del activo. El valor predeterminado para este argumento es el nombre de archivo del paquete de origen.
- defaultBindingProps (sólo lectura)
- Especifica las propiedades de enlace predeterminadas para el activo. Este argumento sólo se aplica a los activos empresariales. Para los activos que no son empresariales, especifique el carácter de asterisco (*) para la coincidencia de patrón. Para los activos empresariales, especifique el valor .* para establecer el argumento como un valor no vacío.
- descripción
- Especifica una descripción del activo.
- destinationUrl
- Especifica el URL de los binarios de activos que deben desplegarse.
- typeAspect
- Especifica el aspecto del tipo de activo.
- relationship
- Especifica la relación del activo. Utilice el carácter de signo más (+) para añadir activos adicionales a la relación existente. Utilice el carácter del signo de número (#) para suprimir un activo existente de la relación. Para sustituir las relaciones existentes, especifique la misma sintaxis que en el mandato importAsset. Si el activo especificado en la relación no existe para la adición o actualización, el mandato devuelve una excepción.
- filePermission
- Especifica la configuración de los permisos de archivo.
- validate
- Especifica si debe validarse el activo. El valor predeterminado es false. El producto no guarda el valor especificado para su validación. Por consiguiente, si selecciona validar el activo (true) ahora y lo actualiza más adelante, cuando edite el activo debe volver a habilitar este valor para que el producto valide los archivos actualizados.
- updateAssociatedCUs
- Especifica si se deben actualizar las unidades de composición que están asociadas con un activo empresarial (Java EE). Este argumento sólo se aplica a los activos
empresariales. El valor predeterminado es none. Especifique
all para actualizar todas las unidades de composición
asociadas con el activo empresarial.
En la operación replace, especifique valores para los argumentos de nombre de AssetOptions, defaultBindingProps, description, destinationUrl, typeAspect, relationship, filePermission, validate y updateAssociatedCUs. En operaciones que no son de replace, especifique los argumentos de nombre de AssetOptions y updateAssociatedCUs.
Valor de retorno
El mandato devuelve el ID de configuración del activo de interés.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.updateAsset('-assetID asset1.zip -operation replace -contents c:/temp/a.zip')
- Utilizando la lista Jython:
AdminTask.updateAsset(['-assetID', 'asset1.zip', '-operation', 'replace', '-contents', 'c:/temp/a.zip'])
- Utilizando la serie Jython:
AdminTask.updateAsset('-assetID asset1.zip – operation merge – contents c:/temp/p.zip')
- Utilizando la lista Jython:
AdminTask.updateAsset(['-assetID', 'asset1.zip', '–operation', 'merge', '–contents', 'c:/temp/p.zip'])
- Utilizando la serie Jython:
AdminTask.updateAsset('-assetID defaultapp.ear – operation add – contents c:/temp/filename.jar – contenturi filename.jar')
- Utilizando la lista Jython:
AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'add', '–contents', 'c:/temp/filename.jar', '–contenturi', 'filename.jar'])
- Utilizando la serie Jython:
AdminTask.updateAsset('-assetID defaultapp.ear –operation replace –contents c:/temp/newapp.ear – AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]')
- Utilizando la lista Jython:
AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'replace', '–contents', 'c:/temp/newapp.ear', '–AssetOptions [[defaultapp.ear .* newdesc "" "" "" "" false all]]'])
- Utilizando la serie Jython:
AdminTask.updateAsset('-assetID defaultapp.ear –operation merge –contents c:/temp/newapp.ear – AssetOptions [[defaultapp.ear all]]')
- Utilizando la lista Jython:
AdminTask.updateAsset(['-assetID', 'defaultapp.ear', '–operation', 'merge', '–contents', 'c:/temp/newapp.ear', '–AssetOptions [[defaultapp.ear all]]'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.updateAsset('-interactive')
viewAsset
El mandato viewAsset muestra opciones adicionales de configuración de activos y los valores configurados.
Objeto de destino
Ninguno
Parámetros necesarios
- -assetID
- Especifica el ID de configuración del activo de interés. Este parámetro acepta un ID de configuración incompleto siempre y cuando el ID coincida con un activo único. (String, obligatorio)
Parámetros opcionales
Ninguno
Valor de retorno
Especificar las opciones del
activo (AssetOptions)
Especifique las opciones para el activo.
*Nombre de activo (name): [defaultapp.ear]
Default Binding Properties (defaultBindingProps):
[defaultbinding.ejbjndi.prefix#defaultbinding.datasource.jndi#defaultbinding.datasource.username
#defaultbinding.datasource.password#defaultbinding.cf.jndi
#defaultbinding.cf.resauth#defaultbinding.virtual.host#defaultbinding.force]
Asset Description (description): []
Asset Binaries Destination Url (destination): [${USER_INSTALL_ROOT}/installedAssets/defaultapp.ear/BASE/defaultapp.ear]
Aspectos de tipo del activo (typeAspect): [WebSphere:spec=j2ee_ear]
Relaciones del activo (relationship): []File Permission (filePermission): [.*\\.dll=755#.*\\.so=755#.*\\.a=755#.*\\.sl=755]
Validar activo (validate): [false]
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.viewAsset('-assetID asset3.zip')
- Utilizando la lista Jython:
AdminTask.viewAsset(['-assetID', 'asset3.zip'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.viewAsset('-interactive')
addCompUnit
EL mandato addCompUnit añade una unidad de composición a una aplicación de nivel de negocio específica. Una unidad de composición representa un activo en una aplicación de nivel de negocio Y habilita el contenido del activo para que interactúe con otros activos de la aplicación. También permite que el entorno de ejecución del producto cargue y ejecute el contenido del activo.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
- -cuSourceID
- Especifica el ID de configuración de origen para la unidad de composición que debe añadirse. Puede especificar un ID de activo o un ID de aplicación de nivel de negocio. (String, obligatorio)
Parámetros opcionales
- -deplUnits
- Especifica las unidades desplegables que deben desplegarse para el activo. Puede especificar un subconjunto de unidades desplegables, todas las unidades desplegables, o utilizar el valor predeterminado como biblioteca compartida. Si no especifica este parámetro, el sistema despliega todas las unidades desplegables. (String, opcional)
- En el caso de activos Java EE, el sistema ignora este parámetro -deplunits e, independientemente del valor especificado, puede añadir activos Java EE como parte de este mandato.
- -cuConfigStrategyFile
- Especifica la vía de acceso completa del archivo para las propiedades de enlace predeterminadas. Este parámetro sólo se aplica a los activos empresariales. (String, opcional)
- -defaultBindingOptions
- Especifica propiedades de enlace JNDI (Java Naming and Directory Interface) opcionales para un activo empresarial. Las propiedades de enlace disponibles dependen del tipo de activo empresarial. Utilice el formato propiedad=valor para especificar una propiedad de enlace predeterminado. Para especificar más de una propiedad, separe cada sentencia propiedad=valor mediante el delimitador #.
- Puede especificar ahora las propiedades de enlace, al crear el activo, o más adelante, al añadir el activo como unidad de composición a una aplicación de nivel de negocio. Si especifica las propiedades de enlace más adelante cuando añada el activo a una aplicación de unidad de negocio, puede utilizar un archivo de estrategia para especificarlas. (String, opcional)
- Utilice las opciones siguientes con el parámetro defaultBindingOptions:
Tabla 2. Propiedades de enlaces addCompUnit -defaultBindingOptions admitidas. Especifique una propiedad de enlace que el tipo de activo admita. Tipo de activo empresarial Propiedades de enlace soportadas Enterprise bean (EJB) defaultbinding.ejbjndi.prefix
defaultbinding.force
Origen de datos defaultbinding.datasource.jndi
defaultbinding.datasource.username
defaultbinding.datasource.password
defaultbinding.force
Fábrica de conexiones defaultbinding.cf.jndi
defaultbinding.cf.resauth
defaultbinding.force
Host virtual defaultbinding.virtual.host
defaultbinding.force
Pasos opcionales
- -CUOptions
- Especifica propiedades adicionales para la unidad de composición. Especifique las opciones
siguientes con el paso CUOptions:
- parentBLA (sólo lectura)
- Especifica la aplicación de nivel de negocio para la nueva unidad de composición.
- backingID (sólo lectura)
- Especifica el ID de origen de la unidad de composición.
- nombre
- Especifica el nombre de la unidad de composición.
- descripción
- Especifica una descripción de la unidad de composición.
- startingWeight
- Especifica el peso inicial de la unidad de composición. Los valores admitidos son del 1 al 2147483647, el valor Integer máximo.
- startedOnDistributed
- Especifica si debe iniciarse la unidad de composición después de distribuir los cambios a los nodos de destino. El valor predeterminado es false.
- restartBehaviorOnUpdate
- Especifica los nodos que deben reiniciarse después de editar la unidad de composición. Especifique ALL para reiniciar todos los nodos de destino. Especifique DEFAULT para reiniciar los nodos controlados por los plug-ins de sincronización. Especifique NONE para evitar que el sistema reinicie los nodos.
- Por ejemplo, especifique la sintaxis de este paso como -CUOptions [[.* .* cu4 "cu4 desc" 0 false DEFAULT]]
- -MapTargets
- Especifica propiedades adicionales para la correlación de destino de la unidad de composición. Especifique las opciones siguientes con el paso MapTargets:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- Para un activo EBA (Enterprise Bundle Archive), este URI es ebaDeploymentUnit.
- servidor
- Especifica el destino o los destinos para desplegar las unidades de composición. El valor predeterminado es el servidor server1. Utilice el carácter de signo más (+) para especificar varios destinos. Utilice el carácter de signo más (+) como prefijo para añadir un destino adicional. Especifique el formato del nombre del objeto completo para cada servidor que no sea un servidor de WebSphere Application Server.
- Por ejemplo, especifique la sintaxis de este paso como -MapTargets [[a1.jar cluster1+cluster2] [a2.jar +server2]]
- -ActivationPlanOptions
- Especifica propiedades adicionales para el plan de activación de
unidades de composición. Especifique las opciones siguientes con el paso ActivationPlanOptions:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- activationPlan
- Especifica una lista de componentes de tiempo de ejecución como plan de activación. Especifique cada plan de activación en el formato specName=xxx,specVersion=yyy, donde specName representa el nombre de la especificación y es obligatorio. Utilice el carácter de signo más (+) para especificar varios planes de activación.
- Por ejemplo, especifique la sintaxis de este paso como -ActivationPlanOptions [[a1.jar specname=actplan0+specname=actplan1] [a2.jar specname=actplan1+specname=actplan2]]
- Para un activo EBA, utilice los valores predeterminados siguientes: -ActivationPlanOptions [[default ""]]
- -CreateAuxCUOptions
- Especifica propiedades adicionales para una unidad de composición auxiliar.
Utilice este paso si el origen de la unidad de composición es un
activo que corresponde a un activo que no tiene la unidad de
composición correspondiente en la aplicación de nivel de negocio. Especifique las opciones siguientes con el paso CreateAuxCUOptions:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- inputAsset (sólo lectura)
- Especifica el ID de origen de la unidad de composición.
- cuID
- Especifica el ID de la unidad de composición que el sistema crea para el activo. No especifique este argumento si no desea crear ninguna unidad de composición nueva.
- matchTarget
- Especifica si debe establecerse una coincidencia entre los destinos de la unidad de composición auxiliar y los destinos de la unidad de composición nueva. El valor predeterminado es true.
- El producto no guarda el valor especificado para matchTarget. Por consiguiente, si selecciona que no coincida con el destino (false) ahora y más tarde edita la unidad de composición, cuando la edite, debe volver a inhabilitar este valor para que el producto no coincida con los destinos.
- Por ejemplo, especifique la sintaxis de este paso como –CreateAuxCUOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]
- -RelationshipOptions
- Especifica propiedades adicionales para las relaciones entre
activos, unidades de composición y aplicaciones de nivel de negocio. Utilice este paso si el ID de origen de la unidad de composición es un activo que tenga una unidad de composición coincidente en la aplicación de nivel de negocio. Especifique las opciones siguientes con el paso RelationshipOptions:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- relationship
- Define las relaciones de las unidades de composición. Especifique el nombre de objeto de la unidad de composición en este formato: cuName=xxx. Utilice el carácter de signo más (+) si desea especificar varios nombres de objetos de unidades de composición. Si la unidad de composición especificada en la relación no existe en la misma aplicación de nivel empresarial, el sistema devuelve un error.
- matchTarget
- Especifica si debe establecerse una coincidencia entre los destinos de la relación de la unidad de composición y los destinos de la nueva unidad de composición. El valor predeterminado es true.
- El producto no guarda el valor especificado para matchTarget. Por consiguiente, si selecciona que no coincida con el destino (false) ahora y más tarde edita la unidad de composición, cuando la edite, debe volver a inhabilitar este valor para que el producto no coincida con los destinos.
- Por ejemplo, especifique la sintaxis de este paso como –RelationshipOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]
- -ContextRootStep
- Para un activo EBA, las raíces de contexto determinan dónde se encuentran las páginas web de un WAB (Web Application Bundle) concreto en tiempo de ejecución.
- La raíz de contexto que especifique aquí combinada con la correlación de servidor definida para crear el URL completo que especifica para acceder a las páginas del WAB. Por ejemplo, si el host predeterminado del servidor de aplicaciones es www.example.com:8080 y la raíz de contexto del WAB es /sample, las páginas web estarán disponibles en www.example.com:8080/sample.
- Debe listar las raíces de contexto para todos los módulos WAB que están incluidos en la aplicación OSGi.
- Especifique la sintaxis de este paso del modo siguiente:
-ContextRootStep [ [nombre_simbólico_paquete_1 versión_paquete_1 raíz_contexto_1] [nombre_simbólico_paquete_2 versión_paquete_2 raíz_contexto_2]
- Por ejemplo, para un archivo EBA que contiene dos WAB
(com.ibm.ws.eba.helloWorldService.web en la versión
1.0.0, que se ha de correlacionar con /hello/web y
com.ibm.ws.eba.helloWorldService.withContextRoot en la
versión 0.9.0, que se ha de correlacionar con /hello/service), el mandato será similar
al siguiente:
-ContextRootStep [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"] [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
- -VirtualHostMappingStep
- Para un activo EBA, utilice un host virtual para asociar un puerto exclusivo con un módulo o aplicación. Los alias de un host virtual identifican los números de puerto definidos para ese host virtual. Se utiliza un número de puerto especificado en un alias de host virtual en el URL utilizado para acceder a artefactos como servlets y archivos JSP (JavaServer Page) en un módulo web. Por ejemplo, el alias myhost:8080 es la parte nombre_host:número_puerto del URL http://myhost:8080/sample.
- Cada WAB contenido en un activo desplegado debe correlacionarse con un host virtual. Los módulos WAB se pueden instalar en el mismo host virtual o dispersarse entre varios hosts virtuales.
- Si especifica un host virtual existente en el archivo ibm-web-bnd o
.xmi para un WAB dado, el host virtual especificado se establece de forma
predeterminada. De lo contrario, el valor de host virtual predeterminado es
default_host, que proporciona varios números de puerto a través de sus
alias:
- 80
- Puerto interno no seguro que se utiliza cuando no se especifica ningún número de puerto.
- 9080
- Puerto interno.
- 9443
- Puerto externo seguro.
- A menos que desee aislar el módulo WAB de otros módulos o recursos del mismo nodo (máquina física), default_host es un host virtual adecuado. Además de default_host, WebSphere Application Server proporciona admin_host, que es el host virtual de la aplicación del sistema de la consola administrativa. admin_host está en el puerto 9060. Su puerto seguro es 9043. No seleccione admin_host a menos que el módulo WAB esté relacionado con la administración del sistema.
- Especifique la sintaxis de este paso del modo siguiente:
-VirtualHostMappingStep [ [nombre_simbólico_paquete_1 versión_paquete_1 nombre_módulo_web_1 host_virtual_1] [nombre_simbólico_paquete_2 versión_paquete_2 nombre_módulo_web_2 host_virtual_2]]
- Por ejemplo, para un archivo EBA que contiene dos WAB
(com.ibm.ws.eba.helloWorldService.web en la versión 1.0.0, que se ha de correlacionar
con default_host y com.ibm.ws.eba.helloWorldService.withContextRoot
en la versión 0.9.0, que se ha de correlacionar con test_host), el mandato será
similar al siguiente:
-VirtualHostMappingStep [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 "HelloWorld service" default_host] [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "HelloWorld second service" test_host]]
- -MapRolesToUsersStep
- Para un activo EBA, utilice este paso para correlacionar roles de seguridad con usuarios o grupos.
- Especifique la sintaxis de este paso del modo siguiente:
-MapRolesToUsersStep [ [role_name everyone? all_authenticated_in_realm? usernames groups]]
Clave:- role_name es un nombre de rol definido en la aplicación.
- everyone? se establece en Sí o No, para especificar si todos están o no en el rol.
- all_authenticated_in_realm? se establece en Sí o No, para especificar si todos los usuarios autenticados pueden acceder al dominio de aplicación.
- nombres_usuario es una lista de nombres de usuario de WebSphere Application Server, separados por el carácter "|".
- grupos es una lista de grupos de WebSphere Application Server, separados por el carácter "|".
Nota: Para nombres_usuario y grupos, la serie vacía "" significa "el uso del valor predeterminado o existente". El valor predeterminado normalmente es que no hay ningún usuario o grupo enlazado al rol. Sin embargo, cuando una aplicación contiene un archivo ibm-application-bnd.xmi, el valor predeterminado de usernames se obtiene de este archivo. Si está desplegando una aplicación que contiene un archivo ibm-application-bnd.xmi y desea eliminar los usuarios enlazados, especifique sólo el carácter "|" (que es el separador de varios nombres de usuario). Esto especifica explícitamente "ningún usuario" y, por lo tanto, garantiza que no hay ningún usuario enlazado al rol. - Por ejemplo:
-MapRolesToUsersStep [ [ROLE1 No Yes "" ""] [ROLE2 No No WABTestUser1 ""] [ROLE3 No No "" WABTestGroup1] [ROLE4 Yes No "" ""]]
- -BlueprintResourceRefBindingStep
- Para un activo EBA, los componentes BluePrint pueden acceder a lasa referencias de recursos de WebSphere Application Server. Cada referencia se declara en un archivo XML Blueprint y se puede proteger mediante un alias de autenticación Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Cada paquete de una aplicación OSGi puede contener cualquier número de declaraciones de referencia de recurso en sus diferentes archivos XML Blueprint.
- Cuando se hace referencia a recursos seguros, esas referencias de recursos se pueden enlazar sólo a un alias de autenticación JCA que existe en cada servidor o clúster en el que se despliega la aplicación OSGi. Una aplicación OSGi se puede desplegar en varios servidores y clústeres que están en el mismo dominio de seguridad. Por lo tanto, cada alias de autenticación JCA debe existir en cualquier el dominio de seguridad de los servidores de destino y los clústeres, o en el dominio de seguridad global.
- Especifique la sintaxis de este paso del modo siguiente:
-BlueprintResourceRefBindingStep [ [ nombre_simbólico_paquete versión_paquete id_referencia_recurso_blueprint nombre_interfaz nombre_jndi tipo_autenticación valor_compartimiento nombre_alias_autenticación ]]
Nota: El valor de nombre_jndi debe coincidir con el nombre jndi que se declara en el atributo filter del elemento de referencia de recursos en el archivo XML de Blueprint. - Por ejemplo, para un archivo EBA que contiene un paquete
com.ibm.ws.eba.helloWorldService.properties.bundle.jar de la Versión 1.0.0, que se va a
enlazar con el alias de autenticación de alias1, el mandato es el siguiente:
-BlueprintResourceRefBindingStep[ [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef javax.sql.DataSource jdbc/Account Container Shareable alias1]]
- -WebModuleMsgDestRefs
- Para un activo EBA, enlazar una referencia de recurso correlaciona una dependencia de recurso de la aplicación web con un recurso real disponible en el entorno de ejecución del servidor. Como mínimo, esto se puede conseguir utilizando una correlación que especifica el nombre JNDI con el que se conoce el recurso en el entorno de ejecución. De forma predeterminada, el nombre JNDI es el ID de recurso que ha especificado en el archivo web.xml durante el desarrollo del paquete de aplicaciones web (WAB). Utilice esta opción para enlazar recursos de tipo message-destination-ref (referencia de destino de mensaje) o resource-env-ref (referencia de entorno de recursos), como se define en la especificación Java JSR-250: Common Annotations para la Plataforma Java.
- Especifique la sintaxis de este paso del modo siguiente:
-WebModuleMsgDestRefs [ [ nombre_simbólico_paquete versión_paquete id_referencia_recurso tipo_recurso nombre_jndi_destino ]]
- Por ejemplo:
-WebModuleMsgDestRefs [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 jms/myQ javax.jms.Queue jms/workQ] [com.ibm.ws.eba.helloWorldService.web 1.0.0 jms/myT javax.jms.Topic jms/notificationTopic]]
- -WebModuleResourceRefs
- Para un activo EBA, enlazar una referencia de recurso correlaciona una dependencia de recurso de la aplicación web con un recurso real disponible en el entorno de ejecución del servidor. Como mínimo, esto se puede conseguir utilizando una correlación que especifica el nombre JNDI con el que se conoce el recurso en el entorno de ejecución. De forma predeterminada, el nombre JNDI es el ID de recurso que ha especificado en el archivo web.xml durante el desarrollo del paquete de aplicaciones web (WAB). Utilice esta opción para enlazar recursos de tipo resource-ref (referencia de recurso), como se define en la especificación Java JSR-250: Common Annotations para la Plataforma Java.
- Especifique la sintaxis de este paso del modo siguiente:
-WebModuleResourceRefs [ [ nombre_simbólico_paquete versión_paquete id_referencia_recurso tipo_recurso nombre_jndi_destino configuración_inicio_sesión propiedades_inicio_sesión propiedades_ampliadas ]]
- Por ejemplo:
-WebModuleResourceRefs [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource jdbc/helloDs "" "" ""] [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
Nota: Si utiliza varias propiedades ampliadas, la sintaxis jython es "extprop1=extval1,extprop2=extval2".
Valor de retorno
WebSphere:cuname=cu4
WebSphere:cuname=cua
WebSphere:cuname=cud
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.addCompUnit('-blaID myBLA – cuSourceID assetname=asset1.zip -CUOptions [[.* .* cu1 "cu1 desc1" 0 false DEFAULT]] -MapTargets [[.* server1]] –ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'myBLA', '–cuSourceID', 'assetname=asset1.zip', '-CUOptions', '[[.* .* cu1 "cu1 desc1" 0 false DEFAULT]]', '-MapTargets', '[[.* server1]]', '–ActivationPlanOptions', '[.* specname=actplan0+specname=actplan1]'])
- Utilizando la serie Jython:
AdminTask.addCompUnit('-blaID myBLA -cuSourceID yourBLA -CUOptions [[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'myBLA', '-cuSourceID', 'yourBLA', '-CUOptions', '[[.* .* cu3 "cu3 desc3" 0 false DEFAULT]]'])
AdminTask.addCompUnit('[
-blaID WebSphere:blaname=helloWorldService
-cuSourceID WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
-CUOptions [
[WebSphere:blaname=helloWorldService.eba
WebSphere:assetname=com.ibm.ws.eba.helloWorldService.eba
com.ibm.ws.eba.helloWorldService_0001.eba "" 1 false DEFAULT]]
-MapTargets [[ebaDeploymentUnit WebSphere:node=node01,server=server1]]
-ActivationPlanOptions [[default ""]]
-ContextRootStep [
[com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"]
[com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
-VirtualHostMappingStep [
[com.ibm.ws.eba.helloWorldService.web 1.0.0
"HelloWorld service" default_host]
[com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0
"HelloWorld second service" test_host]]
-MapRolesToUsersStep [
[ROLE1 No Yes "" ""]
[ROLE2 No No WABTestUser1 ""]
[ROLE3 No No "" WABTestGroup1]
[ROLE4 Yes No "" ""]]
-BlueprintResourceRefBindingStep[
[com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef
javax.sql.DataSource jdbc/Account Container Shareable alias1]]
-WebModuleMsgDestRefs [
[com.ibm.ws.eba.helloWorldService.web 1.0.0
jms/myQ javax.jms.Queue jms/workQ]
[com.ibm.ws.eba.helloWorldService.web 1.0.0
jms/myT javax.jms.Topic jms/notificationTopic]]
-WebModuleResourceRefs [
[com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource
jdbc/helloDs "" "" ""]
[com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource
jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
]')
- Utilizando la serie Jython:
AdminTask.addCompUnit('-blaID theirBLA – cuSourceID asset2.zip – CUOptions [[.* .* cu2 "cu2 desc" 0 false DEFAULT]] -MapTargets [[.* server1+server2]]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'theirBLA', '–cuSourceID', 'asset2.zip', '–CUOptions', '[[.* .* cu2 "cu2 desc" 0 false DEFAULT]]', '-MapTargets', '[[.* server1+server2]]'])
- Utilizando la serie Jython:
AdminTask.addCompUnit('-blaID yourBLA – cuSourceID asset2.zip – deplUnits a.jar – CUOptions [[.* .* cu3 "cu3 desc" 0 false DEFAULT]] –MapTargets [[a.jar server1]] –ActivationPlanOptions [[a.jar specname=actplan1]]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'yourBLA', '–cuSourceID', 'asset2.zip', '–deplUnits', 'a.jar', '–CUOptions', '[[.* .* cu3 "cu3 desc" 0 false DEFAULT]]', '–MapTargets', '[[a.jar server1]]', '–ActivationPlanOptions', '[[a.jar specname=actplan1]]'])
- Utilizando la serie Jython:
AdminTask.addCompUnit('-blaID ourBLA – cuSourceID b.jar – deplUnits default – CUOptions [[.* .* cub "cub desc" 0 false DEFAULT]] –MapTargets [[default server1]]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'ourBLA', '–cuSourceID', 'b.jar', '–deplUnits', 'default', '–CUOptions', '[[.* .* cub "cub desc" 0 false DEFAULT]]', '–MapTargets', '[[default server1]]'])
- Utilizando la serie Jython:
AdminTask.addCompUnit('-blaID ourBLA – cuSourceID asset3.zip – deplUnits a1.jar – CUOptions [[.* .* cu4 "cu4 desc" 0 false DEFAULT]] –MapTargets [[a1.jar cluster1+cluster2]] –CreateAuxCUOptions [[a1.jar a.jar cua true]] –RelationshipOptions [[a1.jar cuname=cub true]]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'ourBLA', '–cuSourceID', 'asset3.zip', '–deplUnits', 'a1.jar', '–CUOptions', '[[.* .* cu4 "cu4 desc" 0 false DEFAULT]]', '–MapTargets', '[[a1.jar cluster1+cluster2]]', '–CreateAuxCUOptions', '[[a1.jar a.jar cua true]]', '–RelationshipOptions', '[[a1.jar cuname=cub true]]'])
- Utilizando la serie Jython:
AdminTask.addCompUnit('[-blaID yourBLA – cuSourceID defaultapp.ear – 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=server2]] -CtxRootForWebMod [[defaultapp.war .* myctx/]]]')
- Utilizando la lista Jython:
AdminTask.addCompUnit(['-blaID', 'yourBLA', '–cuSourceID', 'defaultapp.ear', '–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=server2]]', '-CtxRootForWebMod', '[[defaultapp.war .* myctx/]]'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.addCompUnit('-interactive')
deleteCompUnit
El mandato deleteCompUnit elimina una unidad de composición. Los dos parámetros para este mandato aceptan ID de configuración incompletos, siempre y cuando el sistema pueda establecer una coincidencia entre la serie especificada y un ID exclusivo.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
- -cuID
- Especifica el ID de configuración de la unidad de composición que debe suprimirse. (String, obligatorio)
Parámetros opcionales
- -force
- Especifica si debe forzarse al sistema para que suprima una unidad de composición, aun cuando otras unidades de composición dependan de ella. (Boolean, opcional)
Valor de retorno
WebSphere:cuname=cu1
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.deleteCompUnit('-blaID myBLA – cuID cu1 -force true')
- Utilizando la lista Jython:
AdminTask.deleteCompUnit(['-blaID', 'myBLA', '–cuID', 'cu1', '-force', 'true'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.deleteCompUnit('-interactive')
editCompUnit
El mandato editCompUnit modifica opciones adicionales 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 del plan de activación y los valores de relación.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
- -cuID
- Especifica el ID de configuración de la unidad de composición que debe editarse. (String, obligatorio)
Pasos opcionales
- -CUOptions
- Especifica propiedades adicionales para la unidad de composición. Especifique las opciones
siguientes con el paso CUOptions:
- parentBLA (sólo lectura)
- Especifica la aplicación de nivel de negocio para la unidad de composición.
- backingID (sólo lectura)
- Especifica el ID de origen de la unidad de composición.
- name (sólo lectura)
- Especifica el nombre de la unidad de composición.
- descripción
- Especifica una descripción de la unidad de composición.
- startingWeight
- Especifica el peso inicial de la unidad de composición. Los valores admitidos son del 1 al 2147483647, el valor Integer máximo.
- startedOnDistributed
- Especifica si debe iniciarse la unidad de composición después de distribuir los cambios a los nodos de destino. El valor predeterminado es false.
- restartBehaviorOnUpdate
- Especifica los nodos que deben reiniciarse después de editar la unidad de composición. Especifique ALL para reiniciar todos los nodos de destino. Especifique DEFAULT para reiniciar los nodos controlados por los plug-ins de sincronización. Especifique NONE para evitar que el sistema reinicie los nodos.
- Por ejemplo, especifique la sintaxis para este paso de este modo: -CUOptions [[.* .* cu4 "descripción de cu4" 0 false DEFAULT]]
- -MapTargets
- Especifica propiedades adicionales para la correlación de destino de la unidad de composición. Especifique las opciones siguientes con el paso MapTargets:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- Para un activo EBA (Enterprise Bundle Archive), este URI es ebaDeploymentUnit.
- servidor
- Especifica el destino o los destinos para desplegar las unidades de composición. El valor predeterminado es el servidor server1. Utilice el carácter de signo más (+) para especificar varios destinos. Utilice el carácter de signo más (+) como prefijo para añadir un destino adicional. Especifique el formato del nombre del objeto completo para cada servidor que no sea un servidor de WebSphere Application Server.
- Por ejemplo, especifique la sintaxis de este paso de este modo: -MapTargets [[a1.jar cluster1+cluster2] [a2.jar server1+server2]]
- -ActivationPlanOptions
- Especifica propiedades adicionales para el plan de activación de
unidades de composición. Especifique las opciones siguientes con el paso ActivationPlanOptions:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- activationPlan
- Especifica una lista de componentes de tiempo de ejecución como plan de activación. Especifique cada plan de activación en el formato specName=xxx,specVersion=yyy, donde specName representa el nombre de la especificación y es obligatorio. Utilice el carácter de signo más (+) para especificar varios planes de activación.
- Por ejemplo, especifique la sintaxis de este paso de este modo: -ActivationPlanOptions [[a1.jar specname=actplan0+actplan1] [a2.jar specname=actplan1+specname=actplan2]]
- Para un activo EBA, no modifique el plan de activación. Mantenga los valores predeterminados siguientes que se establecieron al añadir la unidad de composición: -ActivationPlanOptions [[default ""]]
- -RelationshipOptions
- Especifica propiedades adicionales para las relaciones entre
activos, unidades de composición y aplicaciones de nivel de negocio. Utilice este paso si el ID de origen de la unidad de composición es un activo que tenga una unidad de composición coincidente en la aplicación de nivel de negocio. Especifique las opciones siguientes con el paso RelationshipOptions:
- deplUnit (sólo lectura)
- Especifica el URI (Uniform Resource Identifier) de la unidad desplegable.
- relationship
- Define las relaciones de las unidades de composición. Especifique el nombre de objeto de la unidad de composición en este formato: cuName=xxx. Utilice el carácter de signo más (+) si desea especificar varios nombres de objetos de unidades de composición. Si la unidad de composición especificada en la relación no existe en la misma aplicación de nivel empresarial, el sistema devuelve un error.
- matchTarget
- Especifica si debe establecerse una coincidencia entre los destinos de la relación de la unidad de composición y los destinos de la nueva unidad de composición. El valor predeterminado es true.
- El producto no guarda el valor especificado para matchTarget. Por consiguiente, si selecciona que no coincida con el destino (false) ahora y más tarde edita la unidad de composición, cuando la edite, debe volver a inhabilitar este valor para que el producto no coincida con los destinos.
- Por ejemplo, especifique la sintaxis de este paso como –RelationshipOptions [[a1.jar a.jar auxCU true] [a2.jar a.jar defaultCU false]]
- -ContextRootStep
- Para un activo EBA, las raíces de contexto determinan dónde se encuentran las páginas web de un WAB (Web Application Bundle) concreto en tiempo de ejecución.
- La raíz de contexto que especifique aquí combinada con la correlación de servidor definida para crear el URL completo que especifica para acceder a las páginas del WAB. Por ejemplo, si el host predeterminado del servidor de aplicaciones es www.example.com:8080 y la raíz de contexto del WAB es /sample, las páginas web estarán disponibles en www.example.com:8080/sample.
- Debe listar las raíces de contexto para todos los módulos WAB que están incluidos en la aplicación OSGi.
- Especifique la sintaxis de este paso del modo siguiente:
-ContextRootStep [ [nombre_simbólico_paquete_1 versión_paquete_1 raíz_contexto_1] [nombre_simbólico_paquete_2 versión_paquete_2 raíz_contexto_2]
- Por ejemplo, para un archivo EBA que contiene dos WAB
(com.ibm.ws.eba.helloWorldService.web en la versión
1.0.0, que se ha de correlacionar con /hello/web y
com.ibm.ws.eba.helloWorldService.withContextRoot en la
versión 0.9.0, que se ha de correlacionar con /hello/service), el mandato será similar
al siguiente:
-ContextRootStep [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 "/hello/web"] [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "/hello/service"]]
- -VirtualHostMappingStep
- Para un activo EBA, utilice un host virtual para asociar un puerto exclusivo con un módulo o aplicación. Los alias de un host virtual identifican los números de puerto definidos para ese host virtual. Se utiliza un número de puerto especificado en un alias de host virtual en el URL utilizado para acceder a artefactos como servlets y archivos JSP (JavaServer Page) en un módulo web. Por ejemplo, el alias myhost:8080 es la parte nombre_host:número_puerto del URL http://myhost:8080/sample.
- Cada WAB contenido en un activo desplegado debe correlacionarse con un host virtual. Los módulos WAB se pueden instalar en el mismo host virtual o dispersarse entre varios hosts virtuales.
- Si especifica un host virtual existente en el archivo ibm-web-bnd o
.xmi para un WAB dado, el host virtual especificado se establece de forma
predeterminada. De lo contrario, el valor de host virtual predeterminado es
default_host, que proporciona varios números de puerto a través de sus
alias:
- 80
- Puerto interno no seguro que se utiliza cuando no se especifica ningún número de puerto.
- 9080
- Puerto interno.
- 9443
- Puerto externo seguro.
- A menos que desee aislar el módulo WAB de otros módulos o recursos del mismo nodo (máquina física), default_host es un host virtual adecuado. Además de default_host, WebSphere Application Server proporciona admin_host, que es el host virtual de la aplicación del sistema de la consola administrativa. admin_host está en el puerto 9060. Su puerto seguro es 9043. No seleccione admin_host a menos que el módulo WAB esté relacionado con la administración del sistema.
- Especifique la sintaxis de este paso del modo siguiente:
-VirtualHostMappingStep [ [nombre_simbólico_paquete_1 versión_paquete_1 nombre_módulo_web_1 host_virtual_1] [nombre_simbólico_paquete_2 versión_paquete_2 nombre_módulo_web_2 host_virtual_2]]
- Por ejemplo, para un archivo EBA que contiene dos WAB
(com.ibm.ws.eba.helloWorldService.web en la versión 1.0.0, que se ha de correlacionar
con default_host y com.ibm.ws.eba.helloWorldService.withContextRoot
en la versión 0.9.0, que se ha de correlacionar con test_host), el mandato será
similar al siguiente:
-VirtualHostMappingStep [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 "HelloWorld service" default_host] [com.ibm.ws.eba.helloWorldService.withContextRoot 0.9.0 "HelloWorld second service" test_host]]
- -MapRolesToUsersStep
- Para un activo EBA, utilice este paso para correlacionar roles de seguridad con usuarios o grupos.
- Especifique la sintaxis de este paso del modo siguiente:
-MapRolesToUsersStep [ [role_name everyone? all_authenticated_in_realm? usernames groups]]
Clave:- role_name es un nombre de rol definido en la aplicación.
- everyone? se establece en Sí o No, para especificar si todos están o no en el rol.
- all_authenticated_in_realm? se establece en Sí o No, para especificar si todos los usuarios autenticados pueden acceder al dominio de aplicación.
- nombres_usuario es una lista de nombres de usuario de WebSphere Application Server, separados por el carácter "|".
- grupos es una lista de grupos de WebSphere Application Server, separados por el carácter "|".
Nota: Para nombres_usuario y grupos, la serie vacía "" significa "el uso del valor predeterminado o existente". El valor predeterminado normalmente es que no hay ningún usuario o grupo enlazado al rol. Sin embargo, cuando una aplicación contiene un archivo ibm-application-bnd.xmi, el valor predeterminado de usernames se obtiene de este archivo. Si está desplegando una aplicación que contiene un archivo ibm-application-bnd.xmi y desea eliminar los usuarios enlazados, especifique sólo el carácter "|" (que es el separador de varios nombres de usuario). Esto especifica explícitamente "ningún usuario" y, por lo tanto, garantiza que no hay ningún usuario enlazado al rol. - Por ejemplo:
-MapRolesToUsersStep [ [ROLE1 No Yes "" ""] [ROLE2 No No WABTestUser1 ""] [ROLE3 No No "" WABTestGroup1] [ROLE4 Yes No "" ""]]
- -BlueprintResourceRefPostDeployStep
- Para un activo EBA, los componentes BluePrint pueden acceder a lasa referencias de recursos de WebSphere Application Server. Cada referencia se declara en un archivo XML Blueprint y se puede proteger mediante un alias de autenticación Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Cada paquete de una aplicación OSGi puede contener cualquier número de declaraciones de referencia de recurso en sus diferentes archivos XML Blueprint.
- Cuando se hace referencia a recursos seguros, esas referencias de recursos se pueden enlazar sólo a un alias de autenticación JCA que existe en cada servidor o clúster en el que se despliega la aplicación OSGi. Una aplicación OSGi se puede desplegar en varios servidores y clústeres que están en el mismo dominio de seguridad. Por lo tanto, cada alias de autenticación JCA debe existir en cualquier el dominio de seguridad de los servidores de destino y los clústeres, o en el dominio de seguridad global.
- Especifique la sintaxis de este paso del modo siguiente:
-BlueprintResourceRefPostDeployStep [ [ nombre_simbólico_paquete versión_paquete id_referencia_recurso_blueprint nombre_interfaz nombre_jndi tipo_autenticación valor_compartimiento nombre_alias_autenticación ]]
Nota: El valor de nombre_jndi debe coincidir con el nombre jndi que se declara en el atributo filter del elemento de referencia de recursos en el archivo XML de Blueprint. - Por ejemplo, para un archivo EBA que contiene un paquete
com.ibm.ws.eba.helloWorldService.properties.bundle.jar de la Versión 1.0.0, que se va a
enlazar con el alias de autenticación de alias1, el mandato es el siguiente:
-BlueprintResourceRefPostDeployStep[ [com.ibm.ws.eba.helloWorldService.properties.bundle 1.0.0 resourceRef javax.sql.DataSource jdbc/Account Container Shareable alias1]]
- -WebModuleResourceRefs
- Para un activo EBA, al enlazar una referencia de recurso se correlaciona una dependencia de recurso del módulo web con un recurso real disponible en el entorno de ejecución del servidor. Como mínimo, esto se puede conseguir utilizando una correlación que especifica el nombre JNDI con el que se conoce el recurso en el entorno de ejecución. De forma predeterminada, el nombre JNDI es el ID de recurso que ha especificado en el archivo web.xml durante el desarrollo del paquete de aplicaciones web (WAB).
- Especifique la sintaxis de este paso del modo siguiente:
-WebModuleResourceRefs [ [ nombre_simbólico_paquete versión_paquete id_referencia_recurso tipo_recurso nombre_jndi_destino configuración_inicio_sesión propiedades_inicio_sesión propiedades_ampliadas ]]
- Por ejemplo:
-WebModuleResourceRefs [ [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/jtaDs javax.sql.DataSource jdbc/helloDs "" "" ""] [com.ibm.ws.eba.helloWorldService.web 1.0.0 jdbc/nonJtaDs javax.sql.DataSource jdbc/helloDsNonJta "" "" "extprop1=extval1"]]
Nota: Si utiliza varias propiedades ampliadas, la sintaxis jython es "extprop1=extval1,extprop2=extval2".
Valor de retorno
El mandato devuelve el ID de configuración de la unidad de composición que el sistema edita.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.editCompUnit('-blaID myBLA – cuID cu1 – CUOptions [[.* .* cu1 cudesc 1 false DEFAULT]] -MapTargets [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
- Utilizando la lista Jython:
AdminTask.editCompUnit(['-blaID', 'myBLA', '–cuID', 'cu1', '–CUOptions', '[[.* .* cu1 cudesc 1 false DEFAULT]]', '-MapTargets', ' [[.* server2]]', '-ActivationPlanOptions', '[.* #specname=actplan0+specname=actplan2]'])
- Utilizando la serie Jython:
AdminTask.editCompUnit('-blaID ourBLA – cuID cu4 – CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]] –MapTargets [[a1.jar server1+server2]] –RelationshipOptions [[a1.jar cuname=cub true]]')
- Utilizando la lista Jython:
AdminTask.editCompUnit(['-blaID', 'ourBLA', '–cuID', 'cu4', '–CUOptions', ' [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '–MapTargets', '[[a1.jar server1+server2]]', '–RelationshipOptions', '[[a1.jar cuname=cub true]]'])
- Utilizando la serie Jython:
AdminTask.editCompUnit('[-blaID ourBLA – cuID cu4 – CUOptions [[.* .* cu4 "new cu desc" 1 false DEFAULT]] –MapTargets [[a1.jar server1+server2]] –RelationshipOptions [[a1.jar +cuname=cuc true]] -ActivationPlanOptions [a1.jar +specname=actplan2#specname=actplan1]]')
- Utilizando la lista Jython:
AdminTask.editCompUnit(['-blaID', 'ourBLA', '–cuID', 'cu4', '–CUOptions', ' [[.* .* cu4 "new cu desc" 1 false DEFAULT]]', '–MapTargets', '[[a1.jar server1+server2]]', '–RelationshipOptions', '[[a1.jar +cuname=cuc true]]', '-ActivationPlanOptions', '[a1.jar +specname=actplan2#specname=actplan1]'])
- Utilizando la serie Jython:
AdminTask.editCompUnit('-blaID yourBLA – cuID defaultapp – MapModulesToServers [[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]] –CtxRootForWebMod [[defaultapp.war .* /]] –MapWebModToVH [[defaultapp.war .* vh1]]')
- Utilizando la lista Jython:
AdminTask.editCompUnit(['-blaID', 'yourBLA', '–cuID', 'defaultapp', '–MapModulesToServers', '[[defaultapp.war .* WebSphere:cluster=cluster1][Increment.jar .* Websphere:cluster=cluster2]]', '–CtxRootForWebMod', '[[defaultapp.war .* /]]', '–MapWebModToVH', '[[defaultapp.war .* vh1]]'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.editCompUnit('-interactive')
listCompUnits
El mandato listCompUnits muestra cada una de las unidades de composición asociada con una aplicación de nivel de negocio específica.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
Parámetros opcionales
- -includeDescription
- Especifica si incluir una descripción de cada uno de los activos que devuelve el mandato. (String, opcional)
- -includeType
- Especifica si debe incluirse el tipo para cada activo que devuelve el mandato. (String, opcional)
Valor de retorno
Websphere:cuname=cu1
asset
"descripción de cu1"
Websphere:cuname=cu4
bla
"descripción de cu4"
WebSphere:cuname=defaultapp
Java EE
"descripción de defaultapp"
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.listCompUnits('-blaID blaname=theirBLA')
- Utilizando la lista Jython:
AdminTask.listCompUnits(['-blaID', 'blaname=theirBLA'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.listCompUnits('-interactive')
setCompUnitTargetAutoStart
El mandato setCompUnitTargetAutoStart habilita o inhabilita el inicio automático de las unidades de composición. Si habilita esta opción, el sistema inicia automáticamente la unidad de composición cuando se inicia el destino de la misma.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. El mandato acepta un ID de configuración incompleto si el sistema establece una coincidencia del mismo con un ID exclusivo de aplicación de nivel de negocio. (String, obligatorio)
- -cuID
- Especifica la unidad de composición de interés. El mandato acepta un ID de configuración exclusivo si el sistema establece una coincidencia del mismo con un ID de unidad de composición exclusivo. (String, obligatorio)
- -targetID
- Especifica el nombre del destino de interés. Por ejemplo, especifique el nombre de servidor para establecer el destino en un servidor específico. (String, obligatorio)
- -enable
- Especifica si debe iniciarse automáticamente la unidad de composición de interés cuando se inicia el destino especificado. Especifique true para iniciar la unidad de composición automáticamente. Si no especifica true, el sistema no iniciará la unidad de composición cuando se inicie el destino. El valor predeterminado es true. (String, obligatorio)
Valor de retorno
El mandato no devuelve ninguna salida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.setCompUnitTargetAutoStart('-blaID bla1 – cuID cu1 – targetID server1 – enable true')
- Utilizando la lista Jython:
AdminTask.setCompUnitTargetAutoStart(['-blaID', 'bla1', '–cuID', 'cu1', '–targetID', 'server1', '–enable', 'true'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando serie de Jython:
AdminTask.setCompUnitTargetAutoStart('-interactive')
viewCompUnit
El mandato viewCompUnit muestra información sobre la configuración de una unidad de composición que pertenece a una aplicación de nivel de negocio específica.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. Este parámetro acepta un ID de configuración incompleto si el sistema establece una coincidencia del mismo con un ID exclusivo de aplicación de nivel de negocio. (String, obligatorio)
- -cuID
- Especifica el ID de configuración de la unidad de composición. Este parámetro acepta un ID de configuración exclusivo si el sistema establece una coincidencia del mismo con un ID de unidad de composición exclusivo. (String, obligatorio)
Parámetros opcionales
Ninguno
Valor de retorno
Especificar las opciones de la unidad de composición (CUOptions)
Especifique el nombre y las opciones de descripción para la unidad de composición.
Parent BLA (parentBLA): [WebSphere:blaname=myBLA]
Backing Id (backingId): [WebSphere:assetname=asset1.zip]
Nombre (name): [cu1]
Descripción (description): [cuDesc]
Peso inicial (startingWeight): [0]
Iniciado al distribuido (startedOnDistributed): [false]
Comportamiento de reinicio en la actualización (restartBehaviorOnUpdate): [DEFAULT]
Especificar servidor (MapTargets)
Especifique los destinos, como servidores de aplicaciones o clústeres
de servidores de aplicaciones, en los que desea desplegar la unidad
de composición de la aplicación.
Unidad desplegable (deplUnit): [default]
*Servidores (server): [WebSphere:node=miNodo,server=servidor1]
Especificar las opciones del plan de activación de la unidad de composición (ActivationPlanOptions)
Especificar el nombre de optionsDeployableUnit del plan de activación de unidades de composición (deplUnit): [default]
Plan de activación (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1]
- 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.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.viewCompUnit('-blaID myBLA -cuID myCompUnit')
- Utilizando la lista Jython:
AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID', 'myCompUnit'])
- Utilizando la serie Jython:
AdminTask.viewCompUnit('-blaID myBLA -cuID defaultApplication')
- Utilizando la lista Jython:
AdminTask.viewCompUnit(['-blaID', 'myBLA', '-cuID', 'defaultApplication'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.viewCompUnit('-interactive')
createEmptyBLA
Utilice mandato createEmptyBLA para crear una aplicación de nivel de negocio vacía. Una vez que haya creado la aplicación de nivel de negocio, puede añadirle activos u otras aplicaciones de nivel de negocio como unidades de composición.
Objeto de destino
Ninguno
Parámetros necesarios
- -name
- Especifica un nombre exclusivo para la aplicación de nivel de negocio. (String, obligatorio)
Parámetros opcionales
- -description
- Especifica una descripción para la aplicación de nivel de negocio. (String, opcional)
Valor de retorno
WebSphere:blaname=myBLA
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.createEmptyBLA('-name myBLA -description "mi descripción de BLA"')
- Utilizando la lista Jython:
AdminTask.createEmptyBLA(['-name', 'myBLA', '-description', '"mi descripción de BLA"'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.createEmptyBLA('-interactive')
deleteBLA
El mandato deleteBLA elimina una aplicación de nivel de negocio de la configuración. Antes de suprimir una aplicación de nivel de negocio, utilice el mandato deleteCompUnit para eliminar todas las unidades de composición asociadas a la aplicación de nivel de negocio. Asimismo, verifique que ninguna otra aplicación de nivel de negocio hace referencia a la aplicación de nivel de negocio que se debe suprimir.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. El mandato acepta un ID incompleto para el parámetro blaID, siempre y cuando el sistema pueda establecer una coincidencia entre la serie especificada y un identificador exclusivo. Por ejemplo, puede especificar el ID parcial myBLA para identificar el ID de configuración WebSphere:blaname=myBLA. (String, obligatorio)
Parámetros opcionales
Ninguno
Valor de retorno
WebSphere:blaname=myBLA
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.deleteBLA('-blaID myBLA')
- Utilizando la lista Jython:
AdminTask.deleteBLA(['-blaID', 'myBLA'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.deleteBLA('-interactive')
editBLA
El mandato editBLA modifica la descripción de una aplicación de nivel de negocio.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
Pasos opcionales
- -BLAOptions
- Utilice el paso BLAOptions para especificar una nueva descripción
para la aplicación de nivel de negocio de interés.
- name (sólo lectura)
- Especifica el nombre de la aplicación de nivel de negocio.
- descripción
- Especifica una descripción de la aplicación de nivel de negocio.
Valor de retorno
El mandato no devuelve ninguna salida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.editBLA('-blaID DefaultApplication – BLAOptions [[.* "my new description"]]')
- Utilizando la lista Jython:
AdminTask.editBLA(['-blaID', 'DefaultApplication', '–BLAOptions', '[[.* "my new description"]]'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.editBLA('-interactive')
getBLAStatus
El mandato getBLAStatus indica si la aplicación de nivel de negocio o la unidad de composición está ejecutándose o detenida.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. Utilice el mandato listBLAs para visualizar una lista de los ID de configuración e las aplicaciones de nivel de negocio. (String, obligatorio)
Parámetros opcionales
- -cuID
- Especifica el ID de configuración de la unidad de composición. Utilice el mandato listCompUnits para visualizar una lista de los ID de configuración de las unidades de composición. (String, opcional)
Valor de retorno
El mandato devuelve el estado de la aplicación de nivel de negocio o de la unidad de composición.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.getBLAStatus('-blaID WebSphere:blaname=myBLA -cuID Websphere:cuname=cu1')
- Utilizando la lista Jython:
AdminTask.getBLAStatus(['-blaID', 'WebSphere:blaname=myBLA', '-cuID', 'Websphere:cuname=cu1'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.getBLAStatus('-interactive')
listBLAs
El mandato listBLAs muestra las aplicaciones de nivel de negocio de la configuración.
Objeto de destino
Ninguno
Parámetros opcionales
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, opcional)
- -includeDescription
- Especifica si se debe incluir una descripción de cada aplicación de nivel de negocio que devuelva el mandato. Especifique true para mostrar las descripciones de aplicaciones de nivel de negocio. (String, opcional)
Valor de retorno
WebSphere:blaname=myBLA
WebSphere:blaname=yourBLA
Uso del ejemplo de modalidad de proceso por lotes
- En Jython:
AdminTask.listBLAs()
- Utilizando la serie Jython:
AdminTask.listBLAs('-blaID myBLA')
- Utilizando la lista Jython:
AdminTask.listBLAs(['-blaID', 'myBLA'])
- Utilizando la serie Jython:
AdminTask.listBLAs('-includeDescription true')
- Utilizando la lista Jython:
AdminTask.listBLAs(['-includeDescription', 'true'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando serie de Jython:
AdminTask.listBLAs('-interactive')
listControlOps
El mandato listControlOps muestra las operaciones de control para una aplicación de nivel de negocio y las unidades de composición correspondientes.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. (String, obligatorio)
Parámetros opcionales
- -cuID
- Especifica la unidad de composición de interés. (String, opcional)
- -opName
- Especifica el nombre de la operación de interés. (String, opcional)
- -long
- Especifica si debe incluirse información adicional sobre la configuración en la salida del mandato. (String, opcional)
Valor de retorno
"Operación: start"
"Descripción: iniciar la operación"
"ID de manejador de operaciones: com.mycompany.myasset.ControlOpHandler"
"URI de datos de manejador de operaciones: ninguno"
"Operación: detener"
"Descripción: detener la operación"
"ID de manejador de operaciones: com.mycompany.myasset.ControlOpHandler"
"URI de datos de manejador de operaciones: ninguno"
"Operación: clearCache"
"Descripción: borra la memoria caché especificada o todas las memorias caché"
"ID de manejador de operaciones: com.mycompany.myasset.ControlOpHandler"
"URI de datos de manejador de operaciones: ninguno"
"Parámetro: cacheName"
"Descripción: nombre de la memoria caché que debe borrarse. Si no se especifica, se borran todas las memorias caché."
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.listControlOps('-blaID myBLA – cuID myservice.jar – long true')
- Utilizando la lista Jython:
AdminTask.listControlOps(['-blaID', 'myBLA', '–cuID', 'myservice.jar', '–long true'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.listControlOps('-interactive')
startBLA
El mandato startBLA inicia la aplicación de nivel de negocio de interés.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio que se ha de iniciar. El mandato acepta un ID de configuración incompleto si el sistema establece una coincidencia entre la serie especificada y un ID exclusivo de la configuración. (String, obligatorio)
Valor de retorno
ID
de BLA de la BLA iniciada si la BLA no se había iniciado todavía.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.startBLA('-blaID myBLA')
- Utilizando la lista Jython:
AdminTask.startBLA(['-blaID', 'myBLA'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.startBLA('-interactive')
stopBLA
El mandato stopBLA detiene la aplicación de nivel de negocio de interés.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio que se ha de detener. El mandato acepta un ID de configuración incompleto si el sistema establece una coincidencia entre la serie especificada y un ID exclusivo de la configuración. (String, obligatorio)
Valor de retorno
ID de la BLA detenida si la BLA todavía no estaba detenida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.stopBLA('-blaID myBLA')
- Utilizando la lista Jython:
AdminTask.stopBLA(['-blaID', 'myBLA'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.stopBLA('-interactive')
viewBLA
El mandato viewBLA muestra el nombre y la descripción de la aplicación de nivel de negocio de interés.
Objeto de destino
Ninguno
Parámetros necesarios
- -blaID
- Especifica el ID de configuración de la aplicación de nivel de negocio de interés. El mandato acepta un ID de configuración incompleto si el sistema coincide con la serie de una única aplicación de nivel de negocio. (String, obligatorio)
Parámetros opcionales
Ninguno
Valor de retorno
Especificar opciones para la BLA (BLAOptions)
Especificar las opciones para la BLA
*Nombre de BLA (name): [DefaultApplication]
Descripción de BLA (description): []
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.viewBLA('-blaID DefaultApplication')
- Utilizando la lista Jython:
AdminTask.viewBLA(['-blaID', 'DefaultApplication'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.viewBLA('-interactive')